इस प्रोजेक्ट के बारे में

cctrace एक स्थानीय, शून्य-कॉन्फ़िगरेशन TLS-इंटरसेप्टिंग प्रॉक्सी है जो कोडिंग एजेंटों (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 स्ट्रीम, तर्क-प्रयास और प्रॉम्प्ट-कैश निर्णय, पहले-टोकन विलंबता और प्रति-अनुरोध अनुमानित लागत प्रदान करता है। सत्र उस तरह से पुनर्निर्मित किए जाते हैं जैसे एक मानव उन्हें गिनता है, जिसमें समय के साथ लेन दिखाने वाला एक प्रक्षेपवक्र बार, स्पर्श की गई फ़ाइलों के नाम वाली टूल पंक्तियाँ, सबएजेंट शाखाएँ, मॉडल युग और कॉम्पैक्शन सीमाएँ होती हैं। सत्र रीप्ले किसी भी कैप्चर किए गए सत्र को चरणबद्ध या चलाता है, सक्रिय रन के दौरान लाइव टेलिंग के साथ। एक संदर्भ दृश्य समय के साथ एजेंट की विंडो दिखाता है जिसमें एक इंटरैक्टिव अवलोकन होता है: छह संदर्भ श्रेणियों द्वारा रंगीन प्रति वायर अनुरोध स्टैक्ड कॉलम, कॉम्पैक्शन मार्कर और दीवार-घड़ी ब्रेकडाउन। चयन को तीन तरीकों से पढ़ा जा सकता है: संदर्भ ग्राफ़ (आइसिकल अपघटन) के रूप में, रिकॉर्ड की रैखिक धारा के रूप में, या इंजेक्शन और कॉम्पैक्शन की घटनाओं की समयरेखा के रूप में। लागत ट्रैकिंग दिखाती है कि कोटा कहाँ जाता है, कैश रीड/राइट/इनपुट/आउटपुट ब्रेकडाउन के साथ, कैश मिस को कारणों (समाप्त TTL, उपसर्ग परिवर्तन, 529 पुनर्प्रयास) के साथ पहचानता है, और क्लाइंट द्वारा पोल किए गए खाता कोटा प्रदर्शित करता है। इनसाइट्स कमांड दिन, प्रोजेक्ट और क्लाइंट द्वारा रनों में एकत्रित होता है, कैश स्प्लिट और कोटा प्रतिशत के लिए वैकल्पिक गहन स्कैनिंग के साथ। डॉक्टर कमांड एक सत्र की नवीनतम अनुरोध विंडो का निदान करता है, अप्रयुक्त टूल स्कीमा, आवर्ती हार्नेस इंजेक्शन, डुप्लिकेट सामग्री और कैश अक्षमताओं की पहचान करता है, कार्रवाई योग्य लीवर के साथ। ट्रेस .jsonl फ़ाइलों के रूप में सहेजे जाते हैं (.jsonl.zst में संग्रहीत), किसी भी समय cctrace view के साथ फिर से खोले जा सकते हैं, और मार्कडाउन ट्रांसक्रिप्ट या ऑफ़लाइन HTML स्नैपशॉट के रूप में निर्यात किए जा सकते हैं। एक क्रॉस-प्रोजेक्ट डैशबोर्ड सभी लाइव और समाप्त रन दिखाता है, जिसमें एक-क्लिक सत्र दृश्य, स्टॉप नियंत्रण और स्टोरेज प्रबंधन होता है। क्रेडेंशियल हेडर, बॉडी और URL से हटा दिए जाते हैं, इससे पहले कि कुछ भी डिस्क पर पहुंचे। ट्रेस प्रोजेक्ट ट्री के बाहर ~/.local/share/cctrace/ में रहते हैं। टूल को Bun, openssl और लक्ष्य CLI की आवश्यकता होती है, और यह npm या स्टैंडअलोन संकलित बाइनरी के रूप में उपलब्ध है।