عن المشروع

cctrace هو وكيل محلي يعترض TLS وبدون إعداد، يجلس بين عوامل الترميز (Claude Code وOpenAI Codex CLI وGrok CLI وKimi Code CLI وopencode) وواجهاتها البرمجية الخاصة، ويلتقط كل استدعاء HTTP في الوقت الفعلي. على عكس وكلاء عنوان URL الأساسي الذين يرون فقط نقطة نهاية الدردشة، يعترض cctrace على طبقة النقل، ليصل إلى تدفقات OAuth، ونقاط نهاية الاستخدام/الرصيد، واستدعاءات سجل MCP، وطلبات التمهيد، والقياس عن بُعد التي لا يمكن لملاحظة بسيطة لإعادة كتابة URL ملاحظتها. تولّد الأداة تلقائيًا شهادة CA وتكوّن الوكيل للتوجيه عبرها عبر HTTPS_PROXY، دون الحاجة إلى إعداد يدوي. تتم فك تشفير المضيفين من الطرف الأول والتقاطهم بالكامل؛ بينما تمر المضيفات الخارجية (npm وGitHub وapt) كأنفاق معتمة بعدّادات البايت، مما يبقي السجلات خفيفة. توفر واجهة الويب المباشرة عروض طلبات مصنّفة مع رقائق تصفية، وتدفقات SSE مفككة الترميز، وأحكامًا لجهد التفكير وذاكرة التخزين المؤقت للتعليمات، وزمن استجابة أول رمز، والتكلفة التقديرية لكل طلب. تُعاد بناء الجلسات بالطريقة التي يحسبها الإنسان، مع شريط مسار يعرض المسارات عبر الزمن، وصفوف أدوات تسمّي الملفات التي تم لمسها، وفروع الوكلاء الفرعيين، وعصور النموذج، وحدود الضغط. تتيح إعادة تشغيل الجلسة التنقل خطوة بخطوة أو تشغيل أي جلسة ملتقطة، مع تتبع مباشر أثناء التشغيل النشط. يعرض عرض السياق نافذة الوكيل عبر الزمن مع نظرة عامة تفاعلية: أعمدة مكدسة لكل طلب سلكي ملونة بست فئات سياق، وعلامات ضغط، وتفاصيل الوقت الفعلي. يمكن قراءة التحديد بثلاث طرق: كرسم بياني للسياق (تحليل إيكيكل)، أو كتدفق خطي للسجلات، أو كخط زمني للأحداث للحقن والضغط. يُظهر تتبع التكاليف أين تذهب الحصة مع تفاصيل قراءة/كتابة/إدخال/إخراج ذاكرة التخزين المؤقت، ويحدد أخطاء عدم التطابق مع أسبابها (انتهاء TTL، تغييرات البادئة، إعادة محاولات 529)، ويعرض حصة الحساب كما يستطلعها العميل. يجمع أمر insights عبر عمليات التشغيل حسب اليوم والمشروع والعميل، مع فحص عميق اختياري لتقسيمات ذاكرة التخزين المؤقت ونسب الحصة. يشخّص أمر doctor نافذة الطلبات الأخيرة للجلسة، ويحدد مخططات الأدوات غير المستخدمة، وحقن التسخير المتكررة، والمحتوى المكرر، وأوجه القصور في التخزين المؤقت مع روافع قابلة للتنفيذ. تُحفظ السجلات كملفات .jsonl (مؤرشفة إلى .jsonl.zst)، ويمكن إعادة فتحها في أي وقت باستخدام cctrace view، وتصديرها كنصوص markdown أو لقطات HTML دون اتصال. تعرض لوحة المعلومات عبر المشاريع جميع عمليات التشغيل الحية والمنتهية مع عروض جلسات بنقرة واحدة، وعناصر تحكم للإيقاف، وإدارة التخزين. تُنقّح بيانات الاعتماد من الترويسات والأجسام وعناوين URL قبل وصول أي شيء إلى القرص. تعيش السجلات خارج شجرة المشروع في ~/.local/share/cctrace/. تتطلب الأداة Bun وopenssl وCLI الهدف، وهي متاحة عبر npm أو كملف ثنائي مستقل مُجمَّع.