Markdown ایڈیشن

AI-translated from English; not yet reviewed by a fluent editor.

# AgentsView کے ساتھ کوڈنگ ایجنٹ کے ایک سیشن کا آڈٹ کریں

> AgentsView میں کوڈنگ ایجنٹ کا معلوم مقامی ٹرانسکرپٹ تلاش کریں، درج شدہ ٹوکن اور لاگت کے ماخذ کو دیکھیں، اور تخمینوں کو بل سمجھے بغیر ایک دن کی محدود دائرے والی رپورٹ پڑھیں۔

By BIG CHANGE Editorial

Published: 2026-10-17T17:20:34.907Z
Updated: 2026-10-17T17:20:34.907Z
Canonical: https://bigchange.ai/blog/audit-coding-agent-session-agentsview

![Conceptual charcoal illustration of a local computer with one blank transcript line highlighted and an external drive beside it.](https://bigchange.ai/api/media/file/agentsview-local-session-audit-concept-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual AgentsView interface, transcript, usage figure or billing result is depicted.

AgentsView مختلف ٹولز سے کوڈنگ ایجنٹ کے سیشن لاگز کو ایک قابلِ تلاش مقامی آرکائیو میں جمع کر سکتا ہے۔ یہ رہنما اس انجینئرنگ سربراہ کے لیے ہے جسے کوئی معلوم کام ڈھونڈنا، ایجنٹ کے واقعی درج کردہ استعمال کے خانے دیکھنا، اور لاگت کی ہر رقم کا ماخذ پہچاننا ہو۔

یہ مرحلہ وار رہنما AgentsView کے 9 اکتوبر 2026 کے v0.45.0 اجرا اور موجودہ فوری آغاز اور ٹوکن استعمال کے رہنماؤں کی دستاویزات پر مبنی ہے، جنہیں 17 اکتوبر کو دیکھا گیا۔ BIG CHANGE نے AgentsView انسٹال نہیں کیا، کوئی ٹرانسکرپٹ درآمد نہیں کیا، اور ان مراحل کو آزمایا نہیں۔ انسٹال کردہ ورژن دیکھیں، کیونکہ دستاویزات اور اجرا کی فہرستیں بدل سکتی ہیں۔

## شروع کرنے سے پہلے

آپ کو کوڈنگ ایجنٹ کا ایک مکمل سیشن چاہیے جسے پڑھنے کی اجازت ہو، اس کام کا کوئی منفرد فقرہ یا سیشن ID، اور اس کی مقامی لاگ ڈائریکٹری پڑھنے کی اجازت۔ [Quick Start](https://www.agentsview.io/docs/quickstart/) میں macOS، Windows اور Linux کے ڈیسک ٹاپ ڈاؤن لوڈ درج ہیں؛ CLI wheel پیکیج Linux x86\_64 اور aarch64، macOS x86\_64 اور arm64، اور Windows x86\_64 اور arm64 کے لیے ہیں۔ ڈیسک ٹاپ ایپ پیکیج کی صورت آتی ہے؛ سورس سے بلڈ کرنے کے لیے Go، Node اور CGO کی الگ ضروریات ہیں۔ فوری آغاز کے مطابق بنیادی مقامی آرکائیونگ کے لیے ہوسٹڈ اکاؤنٹ یا API کلید درکار نہیں۔

سیشن لاگز میں پرومپٹ، سورس کوڈ، ٹول ان پٹ اور راز ہو سکتے ہیں۔ صرف وہ ڈائریکٹریاں منتخب کریں جنہیں دیکھنے کی آپ کی ٹیم اجازت دیتی ہے۔ آرکائیو کن فراہم کنندگان اور بنیادی ڈائریکٹریوں سے مواد لے سکتا ہے، یہ طے کریں **پہلی بار چلانے سے پہلے**: صرف `agentsview serve` چلانے سے معاونت یافتہ طے شدہ ماخذ فوراً دریافت اور سنک ہو جاتے ہیں۔ اس مشق میں ویب UI کو دستاویز میں دیے گئے لوپ بیک پتے پر رکھیں۔ صرف اس سوال کا جواب لینے کے لیے ہوسٹڈ خام ڈیٹا سنک، PostgreSQL یا ClickHouse کو ترسیل، Gist اشاعت، تیار کردہ بصیرتیں، یا ہوسٹڈ ایمبیڈنگ اینڈ پوائنٹ فعال نہ کریں۔ معنوی تلاش اختیاری ہے؛ عام مکمل متن کی تلاش مقامی انڈیکس سے کام کرتی ہے۔

## 1. انسٹال کریں اور ایگزیکیوٹیبل پہچانیں

اس [انسٹالیشن رہنما](https://www.agentsview.io/docs/quickstart/) سے ایک طریقہ منتخب کریں۔ علیحدہ CLI کے لیے دستاویز میں درج مستقل Python انسٹالیشن یہ ہے:

```sh
pip install agentsview
agentsview --version
```

رہنما `uvx agentsview` کے ذریعے مستقل انسٹالیشن کے بغیر چلانے، پلیٹ فارم کے انسٹالرز اور ڈیسک ٹاپ پیکیجز کے طریقے بھی دیتا ہے۔ macOS پر Homebrew cask ایپ کے ساتھ شامل CLI کو لنک کرتا ہے؛ DMG سے انسٹال کردہ ایپ کی CLI ڈائریکٹری `PATH` میں شامل کرنا پڑ سکتی ہے۔ ورژن پر اعتبار کرنے سے پہلے دیکھیں کہ شیل کو کون سی ایگزیکیوٹیبل مل رہی ہے۔ GitHub نے [v0.45.0](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) کو 9 اکتوبر کا اجرا کہا ہے، مگر اسکرینوں اور رپورٹ کی ساخت سمجھتے وقت اپنے `--version` کے نتیجے کو استعمال کریں۔

## 2. پہلی سنک سے پہلے ماخذ محدود کریں

ہوسٹ CLI یا ڈیسک ٹاپ انسٹالیشن کے لیے نئی ڈیٹا ڈائریکٹری اور اس کی `config.toml` **پہلے** تیار کریں، پھر AgentsView چلائیں۔ [ترتیب کا رہنما](https://www.agentsview.io/docs/configuration/#disabling-session-providers) بتاتا ہے کہ `disabled_agents` مقامی فائل سسٹم فراہم کنندگان کو خارج کرنے کے لیے ہے اور `[agents.<id>].dirs` ایک فراہم کنندہ کی طے شدہ بنیادی ڈائریکٹریاں بدلنے کے لیے ہے۔ **باقی تمام فراہم کنندگان کے ID** اس رہنما کی [Session Discovery جدول](https://www.agentsview.io/docs/configuration/#session-discovery) سے لے کر `disabled_agents` میں درج کریں، اور واحد مجاز فراہم کنندہ کا `dirs` منظور شدہ بنیادی ڈائریکٹری پر مقرر کریں۔ مثلاً `[agents.codex]` کے ساتھ `dirs = ["/approved/codex/sessions"]` دینے سے Codex کی طے شدہ ڈائریکٹریاں بدل جاتی ہیں؛ اپنے نظام کے مطابق راستہ بدلیں۔ اخراج کی مکمل فہرست نہ ہو تو ابھی ہوسٹ ڈیمَن نہ چلائیں۔ صرف `CODEX_SESSIONS_DIR` یا `CLAUDE_PROJECTS_DIR` کی متبادل قدر دینا اسی فراہم کنندہ کی بنیادی ڈائریکٹری بدلتا ہے، مگر دوسرے فراہم کنندگان کی اپنی طے شدہ دریافت فعال رہتی ہے۔

اس آڈٹ کے لیے نیا `AGENTSVIEW_DATA_DIR` استعمال کریں اگر موجودہ آرکائیو میں پہلے سے غیر متعلق سیشن ہو سکتے ہوں۔ ترتیب کا رہنما کہتا ہے کہ غیر فعال فراہم کنندگان کے پہلے سے آرکائیو کردہ سیشن دستیاب رہتے ہیں، اس لیے ترتیب بدلنے سے پرانا آرکائیو صاف نہیں ہوتا۔ یہ بھی بتاتا ہے کہ `disabled_agents` مقامی دریافت اور نگرانی پر لاگو ہوتا ہے، ریموٹ درآمد یا برآمد پر نہیں؛ اس مقامی کام کے لیے ریموٹ ہوسٹ اور برآمدی مقامات کی ترتیب نہ دیں۔

اگر باقی تمام فراہم کنندگان کے اخراج کی فہرست برقرار رکھنا عملی نہ ہو تو الگ تھلگ کنٹینر متبادل ہے۔ [Quick Start کی Docker مثال](https://www.agentsview.io/docs/quickstart/#docker) UI صرف `127.0.0.1` پر دستیاب کرتی ہے، ایجنٹ کا ایک ماخذ صرف پڑھنے کے لیے ماؤنٹ کرتی ہے، اور الگ ڈیٹا والیوم استعمال کرتی ہے۔ ماؤنٹ کریں **صرف** مجاز ماخذ کی بنیادی ڈائریکٹری، اور نئے کنٹینر کے اندر اس سے مطابقت رکھنے والا ڈائریکٹری ویری ایبل مقرر کریں؛ [پروجیکٹ کی Compose مثال](https://github.com/kenn-io/agentsview/blob/main/docker-compose.prod.yaml) کے دوسرے ماؤنٹس چھوڑ دیں۔ کنٹینر کو ہوسٹ کی صرف واضح طور پر ماؤنٹ کی گئی سیشن ڈائریکٹریاں دکھائی دیتی ہیں۔ شائع شدہ Docker امیجز Linux amd64 اور arm64 کے لیے ہیں؛ اس راستے کے لیے کام کرتی ہوئی Docker انسٹالیشن چاہیے۔

## 3. مقامی آرکائیو بنائیں

محدود ماخذ والی ہوسٹ CLI کے لیے دستاویز میں دیا گیا فورگراؤنڈ سرور چلائیں:

```sh
agentsview serve
```

مرحلہ 2 میں ماخذ کا دائرہ مقرر اور جانچ لینے کے بعد یہ `~/.agentsview/sessions.db` یا منتخب ڈیٹا ڈائریکٹری کو تیار کرتا ہے، فعال ایجنٹ کے لاگز ڈھونڈتا ہے، انہیں سنک کرتا ہے، تبدیلیاں دیکھتا رہتا ہے، اور `http://127.0.0.1:8080` کھولتا ہے۔ وہ ٹرمینل کھلا رکھیں۔ پس منظر میں عمل چلانا چاہیں تو `agentsview daemon start` اور `agentsview daemon status` استعمال کریں؛ ڈیسک ٹاپ ایپ اپنا بیک اینڈ خود سنبھالتی ہے۔ پہلے سے چلتا ہوا موافق سرور ممکن ہے صرف اپنا URL بتائے، اس لیے یہ فرض کرنے سے پہلے کہ نئی ترتیب نے مواد لینا کنٹرول کیا، دیکھیں کہ کوئی ڈیمَن پہلے سے چل تو نہیں رہا۔

اگر الگ تھلگ کنٹینر چنا ہے تو اس کے واحد صرف پڑھنے والے ماخذ ماؤنٹ اور نئے ڈیٹا والیوم کی جانچ کے بعد دستاویز والی Docker کمانڈ سے چلائیں۔ اس کا لوپ بیک UI استعمال کریں اور بعد کی `agentsview` CLI رپورٹس اسی کنٹینر کے اندر چلائیں تاکہ وہی آرکائیو پڑھیں۔ ساتھ ہی ہوسٹ پر ماخذ کا دائرہ مقرر کیے بغیر `serve` نہ چلائیں۔

دیکھیں کہ معلوم کام کا ماخذ نظر آ رہا ہے اور غیر مطلوب فراہم کنندگان نہیں۔ سیشن نہ ملے تو یہ نتیجہ نکالنے سے پہلے کہ کوئی سیشن موجود نہیں، منظور شدہ راستہ، فراہم کنندہ کی ترتیب اور سنک کی حالت دیکھیں۔ رپورٹ سے پہلے نئی تبدیل شدہ فائلیں شامل کرنا ضروری ہو تو `agentsview sync` چلائیں؛ سرور بھی تبدیلیاں دیکھتا رہتا ہے۔ کسی مکمل دوبارہ سنک سے پہلے ترتیب دیا گیا دائرہ پھر جانچیں۔

## 4. کام تلاش کریں اور ٹرانسکرپٹ کی تصدیق کریں

ویب UI میں `Ctrl/Cmd+K` سے معلوم کام کا ایک منفرد فقرہ بعینہٖ تلاش کریں۔ پروجیکٹ، ایجنٹ یا تاریخ کے مطابق فہرست محدود کریں، ممکنہ سیشن کھولیں اور اس کے پیغامات و ٹول کالز دیکھیں۔ پورا سیشن ID یا UUID معلوم ہو تو `Ctrl/Cmd+G` اسے براہِ راست کھولتا ہے۔ یہ کنٹرول [Quick Start](https://www.agentsview.io/docs/quickstart/) میں درج ہیں۔ ایجنٹ، سیشن ID اور تاریخ لکھ لیں تاکہ استعمال کے نتیجے کو صحیح گفتگو سے جوڑ سکیں۔

بعینہٖ تلاش سے کام نہ ملے تو چھوٹا فقرہ آزمائیں اور دیکھیں کہ اصل ایجنٹ نے AgentsView کی قابلِ رسائی ڈائریکٹری میں مقامی ٹرانسکرپٹ لکھا ہے۔ صرف ریموٹ سروس، غیر معاون فارمیٹ یا ترتیب شدہ بنیادی ڈائریکٹریوں سے باہر موجود کام کو زیادہ تلاش کر کے واپس نہیں لایا جا سکتا۔ مقامی ماخذ نہ ملنے کی معمول کی اصلاح کے طور پر معنوی انڈیکسنگ یا ٹرانسکرپٹ اپ لوڈ فعال نہ کریں۔

## 5. سیشن کے استعمال والے خانے دیکھیں

ملنے والے سیشن کا استعمال کا منظر کھولیں اور موجود درج شدہ ماڈل، ان پٹ، آؤٹ پٹ، کیش تخلیق اور کیش پڑھنے والے خانے پہچانیں۔ [ٹوکن استعمال کا رہنما](https://www.agentsview.io/docs/token-usage/) لاگت کی رپورٹنگ کو **تجرباتی اور ابھی ارتقا پذیر** کہتا ہے۔ AgentsView اصل لاگز سے ماڈل اور ٹوکن کا میٹا ڈیٹا لیتا ہے اور پیغامات کی قطاروں میں خام ٹوکن استعمال محفوظ رکھتا ہے۔ ماخذ واضح لاگت بتائے تو اسے استعمال کرتا ہے؛ ورنہ قابلِ استعمال ٹوکن اور ماڈل کی شرحوں سے لاگت نکالتا ہے۔ JSON میں ماخذ کی پہچان کے لیے انہیں `reported`، `computed` یا `mixed` کہا جاتا ہے۔

اس ایک سیشن کا مشین سے پڑھا جا سکنے والا ریکارڈ محفوظ کرنا ہو تو [پروجیکٹ کی CLI مثال](https://www.agentsview.io/) یہ کمانڈ استعمال کرتی ہے: `agentsview session usage SESSION_ID --format json`۔ `SESSION_ID` کی جگہ وہ ID رکھیں جسے ٹرانسکرپٹ میں جانچا ہے، اور JSON کام کے نوٹ کے ساتھ محفوظ کریں۔ کوئی کُل رقم بتانے سے پہلے اس آؤٹ پٹ میں دیا گیا ماڈل، ٹوکن کی اقسام اور لاگت کا ماخذ دیکھیں۔

خالی خانہ یا غائب ماڈل کو نامعلوم سمجھیں۔ ایجنٹ نے جو استعمال کبھی لکھا ہی نہیں، AgentsView اسے دوبارہ تشکیل نہیں دے سکتا۔ اجرا کے نوٹس کہتے ہیں کہ Junie CLI درآمد میں صرف IDE میں موجود گفتگو اور ٹول کالز شامل نہیں ہوتیں، جبکہ Antigravity کے سادہ متن والے متبادل میں ٹرانسکرپٹ کا مواد ہوتا ہے مگر ٹوکن استعمال یا لاگت نہیں۔ یہ واضح مثالیں ہیں کہ قابلِ تلاش سیشن میں خرچ کی مکمل رقم لازماً نہیں ہوتی۔ ماخذ کی بتائی رقم پورے سیشن کا کُل بھی ہو سکتی ہے، جبکہ ماڈل کے لحاظ سے تقسیم تخمینہ ہی رہتی ہے۔

## 6. روزانہ رپورٹ کا دائرہ محدود کریں

Usage صفحے کے تاریخ، پروجیکٹ اور ایجنٹ فلٹر سے سیشن والا دن دیکھیں۔ صفحے میں Top Sessions by Cost جدول بھی ہے جو الگ الگ ٹرانسکرپٹ سے جوڑتا ہے۔ جانچی جا سکنے والی ٹرمینل رپورٹ کے لیے نیچے سیشن کی مقامی تاریخ اور ایجنٹ کا نام بدلیں:

```sh
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown
```

روزانہ جدول کیش کے بغیر ان پٹ، آؤٹ پٹ، کیش بنانا اور کیش پڑھنا الگ دکھاتا ہے، اور ماڈل کے لحاظ سے قطاریں تب ہوتی ہیں جب `--breakdown` مقرر ہو۔ تاریخ نظام کے ٹائم زون کے مطابق گروپ ہوتی ہے، جب تک `--timezone` نہ دیا جائے۔ ایک دن کے کُل میں اس ایجنٹ کے دوسرے سیشن بھی ہو سکتے ہیں؛ یہ دائرے اور مقدار کی جانچ ہے، ایک کام کی لاگت نہیں۔ روزانہ رپورٹ کے ساتھ سیشن ID رکھیں اور دیکھیں کہ کون سی قطاریں واقعی اسی کی ہیں۔

قیمتوں کا کیٹلاگ حاصل کیے بغیر رپورٹ کے لیے `--offline` شامل کریں۔ AgentsView کے مطابق یہ ماخذ سنک یا ڈیمَن شروع کیے بغیر موجودہ آرکائیو پڑھتا ہے اور شامل شدہ متبادل قیمتیں استعمال کرتا ہے۔ حالیہ سیشن تبدیلیاں اہم ہوں تو پہلے آرکائیو تازہ کریں؛ آف لائن رپورٹ نئے لاگز دریافت نہیں کر سکتی۔ عام استعمال کمانڈز LiteLLM اور OpenRouter کی قیمتیں لے سکتی ہیں، جبکہ شامل شدہ کیٹلاگ انسٹال کردہ اجرا کے ساتھ پرانا ہوتا جاتا ہے۔

## 7. رقم کا مطلب سمجھیں اور سروس روکیں

ہر رقم کو اس کے ماخذ کے مطابق نشان دیں۔ `Computed` کا مطلب ہے کہ AgentsView نے درج ٹوکن کو منتخب شرحوں سے ضرب دی۔ `Reported` کا مطلب ہے کہ ماخذ نے واضح لاگت دی۔ `Mixed` کا مطلب ہے کہ رپورٹ میں مختلف اقسام ملی ہوئی ہیں۔ ماخذ کی بتائی رقم بھی اس بات کا ثبوت نہیں کہ پورے اکاؤنٹ کے فراہم کنندہ کی انوائس کا حساب ملا لیا گیا ہے۔ متعلقہ فراہم کنندہ کے اپنے بلنگ یا پلان ریکارڈ الگ سے ملائیں، خصوصاً جب سروس درجے، رعایتیں یا سبسکرپشن میں شامل استعمال اہم ہوں۔ AgentsView کی دستاویز کہتی ہے کہ محفوظ استعمال میں وہ درجہ نہ ہو تو Batch، Flex، Priority، علاقائی یا ایک گھنٹے کی کیش کی قیمت اخذ نہیں کی جا سکتی۔ ٹول کی طرف کے کچھ ٹوکن مقامی ٹرانسکرپٹ میں موجود نہیں ہوتے۔

کامیابی کی جانچ ایسا ملتا ہوا ٹرانسکرپٹ ہے جس کا ایجنٹ، ID اور تاریخ منتخب استعمال کے منظر سے مطابقت رکھے، دستیاب ماڈل و ٹوکن خانے درج ہوں اور غیر دستیاب خانے نامعلوم نشان زد ہوں۔ نتیجہ قابلِ تلاش مقامی آرکائیو اور کام یا دن کے استعمال کا محدود نوٹ ہے، انوائس نہیں۔ فورگراؤنڈ میں چلتا `agentsview serve` روکنے کے لیے `Ctrl+C` استعمال کریں، یا پس منظر کا سرور روکنے کے لیے `agentsview daemon stop` چلائیں۔ [Quick Start](https://www.agentsview.io/docs/quickstart/) کے مطابق ڈیمَن روکنے سے ویب UI اور سیشن کی نگرانی دونوں رک جاتے ہیں۔

## بڑی تبدیلی

مقامی ٹرانسکرپٹ لاگت کی بحث کو ایسا نقطۂ آغاز دیتا ہے جس کا سراغ لگایا جا سکے۔ انجینئرنگ سربراہ کسی رقم کو مخصوص درج شدہ کام تک واپس لے جا کر دیکھ سکتا ہے کہ وہ ایجنٹ سے آئی یا قیمتوں کے کیٹلاگ سے۔ لاگ نامکمل ہو تو رپورٹ کو وہ خلا برقرار رکھنا چاہیے۔

## ماخذ اور مزید مطالعہ

- [AgentsView v0.45.0 کے اجرا کے نوٹس](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0): تاریخ کے ساتھ ایجنٹ کی معاونت، Usage کارڈز، سنک اور قیمتوں کے رویے میں تبدیلیاں۔ اجرا کا نوٹ فراہم کنندہ کا ریکارڈ ہے، BIG CHANGE کا ٹیسٹ نہیں۔
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/): معاون انسٹالیشن راستے، سرور اور ڈیمَن کمانڈز، ماخذ کی ترتیب اور مقامی تلاش کے کنٹرول۔
- [AgentsView کی ترتیب](https://www.agentsview.io/docs/configuration/): ماخذ کی دریافت، فراہم کنندگان کو خارج کرنا، آرکائیو کا مقام اور ان کنٹرولز کی حدود۔
- [AgentsView میں ٹوکن استعمال اور لاگت](https://www.agentsview.io/docs/token-usage/): ماخذ کی معاونت، استعمال کی رپورٹس، قیمت کے ماخذ، آف لائن موڈ اور رپورٹنگ کی معلوم حدود۔
- [AgentsView ریپوزٹری](https://github.com/kenn-io/agentsview): سورس کوڈ اور MIT لائسنس؛ ریپوزٹری طے شدہ آرکائیو کو مقامی قرار دیتی ہے۔

## Sources

- [AgentsView v0.45.0 کے اجرا کے نوٹس](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) — تاریخ کے ساتھ اجرا اور خصوصیات و معاونت میں تبدیلیاں۔
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/) — انسٹالیشن، چلانا، ماخذ کا انتخاب اور تلاش کے کنٹرول۔
- [AgentsView کی ترتیب](https://www.agentsview.io/docs/configuration/) — ماخذ کی دریافت، فراہم کنندگان کو خارج کرنا، ڈیٹا ڈائریکٹری اور کنٹرول کی حدود۔
- [AgentsView میں ٹوکن استعمال اور لاگت](https://www.agentsview.io/docs/token-usage/) — تجرباتی استعمال کی رپورٹس، قیمت کا ماخذ اور حدود۔
- [AgentsView سورس ریپوزٹری](https://github.com/kenn-io/agentsview) — سورس، پروجیکٹ کی تفصیل اور MIT لائسنس۔