প্রকল্প সম্পর্কে

ccusage হল একটি কমান্ড-লাইন টুল যা স্থানীয়ভাবে সংরক্ষিত ডেটা থেকে কোডিং এজেন্ট CLI-গুলির টোকেন ব্যবহার এবং খরচ বিশ্লেষণ করে। এটি npx, bunx, pnpm dlx বা Nix-এর মতো প্যাকেজ রানারগুলির মাধ্যমে ইনস্টলেশন ছাড়াই চালানো যায়, এবং দৈনিক, সাপ্তাহিক, মাসিক, সেশন এবং ৫-ঘণ্টার বিলিং ব্লক রিপোর্ট তৈরি করে। সমর্থিত উত্সগুলির মধ্যে রয়েছে 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 এক্সপোর্ট পাওয়া যায় এবং `--no-cost` দিয়ে খরচ কলাম এবং JSON খরচ ক্ষেত্র লুকানো যায়। মূল্য নির্ধারণ প্রি-ক্যাশ করা ডেটা থেকে অফলাইনে ব্যবহার করা যেতে পারে এবং পুনর্নির্মাণ ছাড়াই `ccusage.json` কনফিগারেশন ফাইলে প্রতি-মডেল দাম ওভাররাইড করা যায়। কনফিগারেশন ফাইলগুলির মাধ্যমে ডিফল্ট সেট করাও যায়, সাথে IDE অটোকমপ্লিট এবং ভ্যালিডেশন। একটি statusline মোড কমপ্যাক্ট ডিসপ্লে সরবরাহ করে যা Claude Code স্ট্যাটাস বার হুকের জন্য তৈরি এবং Beta হিসেবে চিহ্নিত। প্রজেক্টটি TypeScript-এ লেখা এবং npm-এ বিতরণ করা হয়, একটি Nix flake সহ যা টুলটিকে তার ডিফল্ট প্যাকেজ এবং অ্যাপ হিসেবে প্রকাশ করে। উন্নয়নে nix-direnv সহ একটি Nix flake ডেভ পরিবেশ এবং ফরম্যাটিং, টেস্টিং ও চেকের জন্য `just` রেসিপি ব্যবহার করা হয়; LiteLLM মূল্য স্ন্যাপশট flake লকের মাধ্যমে পিন করা হয় এবং একটি নির্ধারিত ওয়ার্কফ্লো দ্বারা রিফ্রেশ করা হয়। রিপোজিটরিটি MIT লাইসেন্সযুক্ত।