Why you'd want it
ccusage reads the usage data that coding agent CLIs store locally and turns it into daily, weekly, monthly and session reports, with per-model breakdowns and separate cache token counts. One report covers Claude Code, Codex, OpenCode, Gemini CLI, GitHub Copilot CLI and more than a dozen other tools, and there are Claude Code extras such as 5-hour billing window reports and a status line integration. Output is a table or JSON, and an offline mode uses cached pricing data.
Best for
- Tracking spend across several coding agents
- Claude Code users watching 5-hour usage windows
- Exporting usage as JSON for your own dashboards
Use it when
You want to see how many tokens and dollars your coding agent sessions use, by day, model, session or project.
Skip it if
You need team-wide spend tracking: it only reads local data on the machine where it runs. Costs are calculated from LiteLLM pricing data, not read from your provider bill.
Editor's note
Moved from ryoppippi/ccusage to ccusage/ccusage.