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

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

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

آپ کو کوڈنگ ایجنٹ کا ایک مکمل سیشن چاہیے جسے پڑھنے کی اجازت ہو، اس کام کا کوئی منفرد فقرہ یا سیشن ID، اور اس کی مقامی لاگ ڈائریکٹری پڑھنے کی اجازت۔ Quick Start میں 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. انسٹال کریں اور ایگزیکیوٹیبل پہچانیں

اس انسٹالیشن رہنما سے ایک طریقہ منتخب کریں۔ علیحدہ CLI کے لیے دستاویز میں درج مستقل Python انسٹالیشن یہ ہے:

Terminal
pip install agentsview
agentsview --version

رہنما uvx agentsview کے ذریعے مستقل انسٹالیشن کے بغیر چلانے، پلیٹ فارم کے انسٹالرز اور ڈیسک ٹاپ پیکیجز کے طریقے بھی دیتا ہے۔ macOS پر Homebrew cask ایپ کے ساتھ شامل CLI کو لنک کرتا ہے؛ DMG سے انسٹال کردہ ایپ کی CLI ڈائریکٹری PATH میں شامل کرنا پڑ سکتی ہے۔ ورژن پر اعتبار کرنے سے پہلے دیکھیں کہ شیل کو کون سی ایگزیکیوٹیبل مل رہی ہے۔ GitHub نے v0.45.0 کو 9 اکتوبر کا اجرا کہا ہے، مگر اسکرینوں اور رپورٹ کی ساخت سمجھتے وقت اپنے --version کے نتیجے کو استعمال کریں۔

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

ہوسٹ CLI یا ڈیسک ٹاپ انسٹالیشن کے لیے نئی ڈیٹا ڈائریکٹری اور اس کی config.toml پہلے تیار کریں، پھر AgentsView چلائیں۔ ترتیب کا رہنما بتاتا ہے کہ disabled_agents مقامی فائل سسٹم فراہم کنندگان کو خارج کرنے کے لیے ہے اور [agents.<id>].dirs ایک فراہم کنندہ کی طے شدہ بنیادی ڈائریکٹریاں بدلنے کے لیے ہے۔ باقی تمام فراہم کنندگان کے ID اس رہنما کی 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 مثال UI صرف 127.0.0.1 پر دستیاب کرتی ہے، ایجنٹ کا ایک ماخذ صرف پڑھنے کے لیے ماؤنٹ کرتی ہے، اور الگ ڈیٹا والیوم استعمال کرتی ہے۔ ماؤنٹ کریں صرف مجاز ماخذ کی بنیادی ڈائریکٹری، اور نئے کنٹینر کے اندر اس سے مطابقت رکھنے والا ڈائریکٹری ویری ایبل مقرر کریں؛ پروجیکٹ کی Compose مثال کے دوسرے ماؤنٹس چھوڑ دیں۔ کنٹینر کو ہوسٹ کی صرف واضح طور پر ماؤنٹ کی گئی سیشن ڈائریکٹریاں دکھائی دیتی ہیں۔ شائع شدہ Docker امیجز Linux amd64 اور arm64 کے لیے ہیں؛ اس راستے کے لیے کام کرتی ہوئی Docker انسٹالیشن چاہیے۔

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

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

Terminal
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 میں درج ہیں۔ ایجنٹ، سیشن ID اور تاریخ لکھ لیں تاکہ استعمال کے نتیجے کو صحیح گفتگو سے جوڑ سکیں۔

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

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

ملنے والے سیشن کا استعمال کا منظر کھولیں اور موجود درج شدہ ماڈل، ان پٹ، آؤٹ پٹ، کیش تخلیق اور کیش پڑھنے والے خانے پہچانیں۔ ٹوکن استعمال کا رہنما لاگت کی رپورٹنگ کو تجرباتی اور ابھی ارتقا پذیر کہتا ہے۔ AgentsView اصل لاگز سے ماڈل اور ٹوکن کا میٹا ڈیٹا لیتا ہے اور پیغامات کی قطاروں میں خام ٹوکن استعمال محفوظ رکھتا ہے۔ ماخذ واضح لاگت بتائے تو اسے استعمال کرتا ہے؛ ورنہ قابلِ استعمال ٹوکن اور ماڈل کی شرحوں سے لاگت نکالتا ہے۔ JSON میں ماخذ کی پہچان کے لیے انہیں reported، computed یا mixed کہا جاتا ہے۔

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

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

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

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

Terminal
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 کے مطابق ڈیمَن روکنے سے ویب UI اور سیشن کی نگرانی دونوں رک جاتے ہیں۔

بڑی تبدیلی

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

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

  • AgentsView v0.45.0 کے اجرا کے نوٹس: تاریخ کے ساتھ ایجنٹ کی معاونت، Usage کارڈز، سنک اور قیمتوں کے رویے میں تبدیلیاں۔ اجرا کا نوٹ فراہم کنندہ کا ریکارڈ ہے، BIG CHANGE کا ٹیسٹ نہیں۔
  • AgentsView Quick Start: معاون انسٹالیشن راستے، سرور اور ڈیمَن کمانڈز، ماخذ کی ترتیب اور مقامی تلاش کے کنٹرول۔
  • AgentsView کی ترتیب: ماخذ کی دریافت، فراہم کنندگان کو خارج کرنا، آرکائیو کا مقام اور ان کنٹرولز کی حدود۔
  • AgentsView میں ٹوکن استعمال اور لاگت: ماخذ کی معاونت، استعمال کی رپورٹس، قیمت کے ماخذ، آف لائن موڈ اور رپورٹنگ کی معلوم حدود۔
  • AgentsView ریپوزٹری: سورس کوڈ اور MIT لائسنس؛ ریپوزٹری طے شدہ آرکائیو کو مقامی قرار دیتی ہے۔