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

cost-xray, AI कोडिंग एजेंट के लिए एक लोकल कैप्चर और लागत-आवंटन टूल है। यह बाद में लोकल ट्रांसक्रिप्ट पढ़ने के बजाय Claude Code और Codex द्वारा भेजे जाने वाले वास्तविक API अनुरोधों को इंटरसेप्ट करता है, फिर हर अनुरोध को उसके घटक स्रोतों में तोड़कर उनकी कीमत निकालता है। यह क्यों मौजूद है: लॉग-आधारित उपयोग टूल किसी कॉल या सेशन की कुल लागत दिखाते हैं, लेकिन अनुरोध-समय का संदर्भ — सिस्टम प्रॉम्प्ट, इंजेक्ट किए गए टूल स्कीमा, MCP ब्लॉक, टूल परिणाम, कैश रीड/राइट, पूर्व थिंकिंग ब्लॉक — अनुरोध के समय ही तैयार होता है और कभी ट्रांसक्रिप्ट में नहीं लिखा जाता। वह अदृश्य प्रीफ़िक्स संदर्भ का बड़ा हिस्सा हो सकता है। cost-xray कच्चे वायर अनुरोध को पढ़ता है ताकि वह टोकन और डॉलर को स्कीमा, MCP सर्वर, टूल और मैसेज बकेट के हिसाब से, अलग-अलग टूल कॉल तक आवंटित कर सके। यह कैसे काम करता है: mitmproxy एक लोकल कैप्चर हॉप के रूप में चलता है। Claude Code को रिवर्स-प्रॉक्सी मोड में बेस-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।