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

ccusage एक कमांड-लाइन उपकरण है जो स्थानीय रूप से संग्रहीत डेटा से कोडिंग एजेंट CLI के टोकन उपयोग और लागतों का विश्लेषण करता है। इसे npx, bunx, pnpm dlx या Nix जैसे पैकेज रनर के माध्यम से बिना स्थापना के चलाया जाता है, और यह दैनिक, साप्ताहिक, मासिक, सत्र और 5-घंटे बिलिंग ब्लॉक रिपोर्ट तैयार करता है। समर्थित स्रोतों में Claude Code, Codex, OpenCode, Amp, Droid, Codebuff, Hermes Agent, pi-agent, Goose, OpenClaw, Kilo, Kimi, Qwen, GitHub Copilot CLI, Gemini CLI, Antigravity, Grok Build CLI और ZCode शामिल हैं। प्रत्येक स्रोत के लिए एक केंद्रित उपकमांड है (उदाहरण के लिए `ccusage claude daily` या `ccusage codex daily`), जबकि `ccusage daily`, `weekly`, `monthly` और `session` सभी पहचाने गए स्रोतों को एक रिपोर्ट में समेकित करते हैं। एक `--by-agent` विकल्प एकीकृत रिपोर्टों को एजेंट द्वारा समूहित करता है, और `--sections` चयन करता है कि कौन से रिपोर्ट अनुभाग शामिल किए जाएँ। रिपोर्ट सुविधाओं में प्रति-मॉडल ट्रैकिंग और लागत विवरण, कैश निर्माण और कैश रीड टोकन कॉलम, `--since` और `--until` के साथ दिनांक फ़िल्टरिंग, `--last` के साथ हालिया-अवधि शॉर्टकट, समय क्षेत्र चयन, कस्टम स्थानीय डेटा पथ, और `--instances` तथा `--project` के माध्यम से Claude Code परियोजना समूहीकरण शामिल हैं। आउटपुट एक उत्तरदायी रंगीन तालिका है जो संकीर्ण टर्मिनलों पर एक कॉम्पैक्ट लेआउट में बदल जाती है, जिसमें स्क्रीनशॉट के लिए इसे बलपूर्वक लागू करने हेतु `--compact` फ्लैग है। `--json` के साथ संरचित JSON निर्यात उपलब्ध है, और लागत कॉलम तथा JSON लागत फ़ील्ड को `--no-cost` से छिपाया जा सकता है। मूल्य निर्धारण पूर्व-कैश्ड डेटा से ऑफ़लाइन उपयोग किया जा सकता है, और प्रति-मॉडल कीमतों को पुनर्निर्माण के बिना `ccusage.json` कॉन्फ़िगरेशन फ़ाइल में ओवरराइड किया जा सकता है। कॉन्फ़िगरेशन फ़ाइलें IDE ऑटोकम्प्लीट और सत्यापन के साथ डिफ़ॉल्ट सेट करने की भी अनुमति देती हैं। एक स्टेटसलाइन मोड क्लॉड कोड स्टेटस बार हुक के लिए अभिप्रेत एक कॉम्पैक्ट डिस्प्ले प्रदान करता है और इसे बीटा चिह्नित किया गया है। परियोजना TypeScript में लिखी गई है और npm पर वितरित की गई है, जिसमें एक Nix फ्लेक उपकरण को अपने डिफ़ॉल्ट पैकेज और ऐप के रूप में उजागर करता है। विकास nix-direnv और `just` व्यंजनों के साथ एक Nix फ्लेक देव वातावरण का उपयोग करता है जो स्वरूपण, परीक्षण और जाँच के लिए है; LiteLLM मूल्य स्नैपशॉट फ्लेक लॉक के माध्यम से पिन किया गया है और एक अनुसूचित वर्कफ़्लो द्वारा ताज़ा किया जाता है। रिपॉजिटरी MIT लाइसेंस प्राप्त है।