منصوبے کے بارے میں

cctrace ایک مقامی، زیرو-کنفیگ TLS-intercepting پراکسی ہے جو کوڈنگ ایجنٹس (Claude Code، OpenAI Codex CLI، Grok CLI، Kimi Code CLI، اور opencode) اور ان کی متعلقہ APIs کے درمیان بیٹھ کر ہر HTTP کال کو ریئل ٹائم میں کیپچر کرتا ہے۔ بیس-URL پراکسیوں کے برعکس جو صرف چیٹ اینڈ پوائنٹ دیکھتی ہیں، cctrace ٹرانسپورٹ لیئر پر مداخلت کرتا ہے، جس سے OAuth فلو، استعمال/کریڈٹ اینڈ پوائنٹس، MCP رجسٹری کالز، بوسٹریپ درخواستیں، اور ٹیلی میٹری تک رسائی ملتی ہے جو ایک سادہ URL ری رائٹ نہیں دیکھ سکتا۔ یہ ٹول خودکار طور پر CA سرٹیفکیٹ بناتا ہے اور ایجنٹ کو HTTPS_PROXY کے ذریعے اس سے گزرنے کے لیے کنفیگر کرتا ہے، جس میں کوئی دستی سیٹ اپ درکار نہیں۔ فرسٹ پارٹی ہوسٹس کو ڈیکرپٹ کر کے مکمل طور پر کیپچر کیا جاتا ہے؛ بیرونی ہوسٹس (npm، GitHub، apt) شفاف بائیٹ-شمار شدہ ٹنلز کے طور پر گزرتی ہیں، جس سے ٹریس ہلکے رہتے ہیں۔ لائیو ویب UI فلٹر چپس، ڈی کوڈ شدہ SSE اسٹریمز، reasoning-effort اور prompt-cache کے فیصلوں، فرسٹ-ٹوکن لیٹنسی، اور فی درخواست تخمینی لاگت کے ساتھ درجہ بند درخواست کے نظارے فراہم کرتا ہے۔ سیشنز اس طرح دوبارہ ترتیب دیے جاتے ہیں جیسے انسان انہیں شمار کرتا ہے، جس میں ٹریجیکٹری بار وقت کے ساتھ لینز دکھاتا ہے، ٹول قطاریں چھوئے گئے فائلوں کے نام دیتی ہیں، سب ایجنٹ برانچز، ماڈل ایپوکس، اور کمپیکشن باؤنڈریز۔ سیشن ری پلے کسی بھی کیپچر شدہ سیشن کو مرحلہ وار یا پلے بیک کرتا ہے، جس میں فعال رنز کے دوران لائیو ٹیلنگ ہوتی ہے۔ ایک کنٹیکسٹ ویو ایجنٹ کی ونڈو کو وقت کے ساتھ ایک انٹرایکٹو جائزہ کے ساتھ دکھاتا ہے: فی وائر درخواست اسٹیکڈ کالم جو چھ کنٹیکسٹ کیٹیگریز کے لحاظ سے رنگین ہوتے ہیں، کمپیکشن مارکر، اور وال-کلاک بریک ڈاؤن۔ انتخاب کو تین طریقوں سے پڑھا جا سکتا ہے: ایک کنٹیکسٹ گراف (آئسکل ڈیکمپوزیشن)، ریکارڈز کی ایک لکیری سٹریم، یا انجیکشنز اور کمپیکشنز کی ایونٹس ٹائم لائن۔ لاگت سے باخبر رہنا دکھاتا ہے کہ کوٹہ کہاں جاتا ہے، کیش ریڈ/رائٹ/انپٹ/آؤٹ پٹ بریک ڈاؤن کے ساتھ، کیش مسز کی وجوہات (میعاد ختم شدہ TTL، پریفکس تبدیلیاں، 529 ریٹرائز) کی نشاندہی کرتا ہے، اور اکاؤنٹ کوٹہ دکھاتا ہے جیسا کہ کلائنٹ پول کرتا ہے۔ insights کمانڈ رنز کو دن، پروجیکٹ، اور کلائنٹ کے لحاظ سے اکٹھا کرتا ہے، کیش اسپلٹس اور کوٹہ فیصد کے لیے اختیاری ڈیپ اسکیننگ کے ساتھ۔ doctor کمانڈ کسی سیشن کی تازہ ترین درخواست ونڈو کی تشخیص کرتا ہے، غیر استعمال شدہ ٹول اسکیما، بار بار ہارنس انجیکشن، ڈپلیکیٹ مواد، اور کیش نااہلیوں کی شناخت کرتا ہے جس میں قابل عمل طریقے بتائے جاتے ہیں۔ ٹریسز .jsonl فائلوں کے طور پر محفوظ کیے جاتے ہیں (آرکائیو شدہ .jsonl.zst میں)، جنہیں کسی بھی وقت cctrace view کے ساتھ دوبارہ کھولا جا سکتا ہے، اور مارک ڈاؤن ٹرانسکرپٹس یا آف لائن HTML سنیپ شاٹس کے طور پر ایکسپورٹ کیا جا سکتا ہے۔ ایک کراس پروجیکٹ ڈیش بورڈ تمام لائیو اور مکمل شدہ رنز کو ون-کلک سیشن ویوز، اسٹاپ کنٹرولز، اور اسٹوریج مینجمنٹ کے ساتھ دکھاتا ہے۔ اسناد کو ہیڈرز، باڈیز، اور URLs سے اس سے پہلے ہٹا دیا جاتا ہے کہ کچھ بھی ڈسک پر لکھا جائے۔ ٹریس پروجیکٹ ٹری سے باہر ~/.local/share/cctrace/ میں رہتے ہیں۔ ٹول کو Bun، openssl، اور ٹارگٹ CLI کی ضرورت ہوتی ہے، اور یہ npm کے ذریعے یا اسٹینڈ الون کمپائلڈ بائنری کے طور پر دستیاب ہے۔