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

cost-xray ایک مقامی کیپچر اور لاگت کی منسوبی کا آلہ ہے جو AI کوڈنگ ایجنٹس کے لیے بنایا گیا ہے۔ یہ بعد ازاں مقامی ٹرانسکرپٹس پڑھنے کے بجائے Claude Code اور Codex کی بھیجی گئی اصل API درخواستوں کو روکتا ہے، پھر ہر درخواست کو اس کے اجزاء کے ماخذوں میں تقسیم کر کے ان کی قیمت لگاتا ہے۔ یہ کیوں موجود ہے: لاگ پر مبنی استعمال کے آلات کسی کال یا سیشن کی کل لاگت دکھاتے ہیں، لیکن درخواست کے وقت کا سیاق و سباق — سسٹم پرامپٹس، انجیکٹ شدہ ٹول اسکیماز، MCP بلاکس، ٹول نتائج، کیش ریڈز/رائٹس، سابقہ سوچ کے بلاکس — درخواست کے وقت جمع ہوتا ہے اور کبھی ٹرانسکرپٹ میں نہیں لکھا جاتا۔ یہ پوشیدہ سابقہ حصہ سیاق و سباق کا بڑا حصہ ہو سکتا ہے۔ cost-xray خام وائر درخواست پڑھتا ہے تاکہ ٹوکنز اور ڈالرز کو اسکیماز، MCP سرورز، ٹولز، اور پیغام کی بالٹیوں سے منسوب کر سکے، حتیٰ کہ انفرادی ٹول کالز تک۔ یہ کیسے کام کرتا ہے: mitmproxy ایک مقامی کیپچر ہاپ کے طور پر چلتا ہے۔ Claude Code کو ریورس-پراکسی موڈ میں base-URL اوور رائیڈ کے ذریعے کیپچر کیا جاتا ہے (کوئی سرٹیفکیٹ نہیں)؛ Codex فارورڈ پراکسی کے ساتھ ایک محدود مقامی CA استعمال کرتا ہے جس پر صرف codex کمانڈ بھروسا کرتی ہے۔ پراکسی 127.0.0.1 پر بائنڈ ہوتا ہے، کوئی ٹیلی میٹری نہیں بھیجتا، اور ~/.cost-xray/ کے تحت ڈسک پر لکھنے سے پہلے Authorization ہیڈرز، API کیز، کوکیز، اور خفیہ دکھنے والے باڈی فیلڈز کو ریڈیکٹ کرتا ہے۔ تجزیہ درخواست کے راستے سے ہٹ کر ایک الگ میٹریلائزر میں چلتا ہے، لہٰذا ٹوکنائزنگ اور قیمت لگانا لائیو ریلے میں تاخیر نہیں ڈالتے۔ کیپچر شدہ ٹریفک کو منفرد بلاک کے ذریعے فی-ٹرن ڈیلٹاز کے ساتھ ڈیڈپلیکیٹ کیا جاتا ہے، جس سے ملین ٹوکن سیشنز کے لیے بھی ڈسک کا استعمال کم رہتا ہے۔ README میں بیان کردہ خصوصیات: فی-ماخذ لاگت کی منسوبی جو تازہ، کیش-ریڈ، کیش-رائٹ، اور آؤٹ پٹ ٹوکنز میں تقسیم ہوتی ہے، اور انفرادی کال تک قیمت لگائی جاتی ہے؛ سیاق و سباق کی ونڈو کی بھرائی جو ماخذ کی سطح کی قطاروں میں تقسیم ہوتی ہے؛ ہر درخواست میں انجیکٹ ہونے والے لیکن کبھی کال نہ ہونے والے کنفیگر شدہ MCP سرورز اور ٹولز کی شناخت؛ Claude کے لیے ٹوکنائزیشن کا طریقہ جو tiktoken تخمینہ کے ساتھ ساتھ فراہم کنندہ کے اپنے استعمال کے مجموعوں کے خلاف متناسب کیلیبریشن استعمال کرتا ہے (مجموعے درست، فی-ماخذ تقسیم تخمینی)؛ خود-شفا یاب ریپرز جو پراکسی کو دوبارہ شروع کرتے ہیں یا براہ راست ایجنٹ ایگزیکیوشن پر واپس چلے جاتے ہیں؛ اور ایک لائیو TUI۔ تنصیب ایک curl-پائپڈ انسٹال اسکرپٹ ہے جو پوچھتا ہے کہ کون سے ایجنٹس کیپچر کرنے ہیں، یا COST_XRAY_AGENTS=claude|codex|all قبول کرتا ہے۔ کیپچر صرف آگے کی طرف ہے اور اس کے لیے نئی ٹرمینل درکار ہے۔ cx CLI TUI کھولتا ہے اور سروسز کا انتظام کرتا ہے (status, stop, start, restart, install, uninstall)۔ تقاضے macOS یا Linux، ایک معاون ایجنٹ، اور کوئی API کیز یا اکاؤنٹ نہیں۔ لائسنس MIT۔