Devtoolwatch Boardccusage review
ccusage is a local CLI that analyzes token usage and estimated costs from coding agent CLIs like Claude Code, Codex, and Gemini CLI.
TL;DR
ccusage reads local usage logs from coding agent CLIs and turns them into daily, weekly, monthly, and session reports with token counts and USD cost estimates. It is for developers who use tools like Claude Code, Codex, OpenCode, or GitHub Copilot CLI. It covers many agents in one report and reads data locally without uploading it.
- 19.3kGitHub stars
- +131new stars, week of Oct 25
- ~214.7kdownloads a week, −16% vs 4-week avg
- #96in Coding agents this week
ccusage at a glance
- Category
- Coding agents
- Maintained by
- ccusage (organization, @ccusage on GitHub)
- Language
- Rust, Nix, TypeScript
- Repository
- github.com/ccusage/ccusage
- Website
- ccusage.com
- npm package
- ccusage 20.0.40
- Latest release
- v20.0.40 on GitHub, Oct 21, 2026
- First published
- May 29, 2025
What ccusage does
- ccusage builds daily, weekly, monthly, and session reports of token usage and costs from local coding agent CLI data.
- ccusage combines usage from every detected source, including Claude Code, Codex, OpenCode, Amp, Gemini CLI, and GitHub Copilot CLI, into one report.
- ccusage estimates USD spend from token counts and model pricing, and tracks cache creation and cache read tokens separately.
- ccusage tracks Claude Code usage within 5-hour billing windows and offers a Claude Code status line for hooks (Beta).
- ccusage exports reports as structured JSON with --json and can hide cost fields with --no-cost.
- ccusage filters reports by date range, recent periods, timezone, and Claude Code project or instance.
- ccusage supports per-model cost breakdowns with --breakdown and custom pricing overrides in ccusage.json.
How it works
ccusage runs as a terminal command, usually through a package runner such as npx or bunx without a global install. It reads local usage logs written by supported coding agent CLIs and prices tokens using LiteLLM pricing data. An --offline flag uses pre-cached pricing without network access. Output is a responsive terminal table or JSON. Claude Code blocks and statusline features depend on Claude-specific local data and hooks.
How to install and start using ccusage
With npx
npx ccusage@latestWith bunx
bunx ccusageWith Nix
nix run github:ccusage/ccusage -- dailyRequirements
- A package runner such as npx, bunx, pnpm dlx, or Nix to run the CLI.
- Local usage data from at least one supported coding agent CLI.
First steps
- Run `npx ccusage@latest` to see a daily report of all detected coding agent CLI usage.
- Narrow to one source with a focused command such as `ccusage claude daily` or `ccusage codex daily`.
- Use `--last 1` on a daily, weekly, or monthly report to see today, this week, or this month.
- Add `--json` to export the report in structured JSON for scripts.
Who ccusage is for
- Developers who want to track token spend across several coding agent CLIs in one place.
- Claude Code users monitoring usage within 5-hour billing windows or in the status bar.
- Teams scripting usage reports from JSON output.
Limitations to know
- ccusage shows estimated costs computed from token counts and model pricing, not billed amounts.
- ccusage blocks and statusline reports work only with Claude Code, since they depend on Claude-specific data and hooks.
- ccusage statusline integration is marked Beta.
- ccusage only reads local data, so usage from other machines is not included.
Is ccusage growing? Usage data
In the week of Oct 25–31, 2026, ccusage ranked #327 on the Devtoolwatch Board and #96 in Coding agents, with a momentum score of 26 out of 100. Its main package had about 214.7k downloads that week, −16% against its own 4-week average.
Show the weekly numbers
| Week of | New stars |
|---|---|
| Aug 9, 2026 | 154 |
| Aug 16, 2026 | 169 |
| Aug 23, 2026 | 110 |
| Aug 30, 2026 | 162 |
| Sep 6, 2026 | 148 |
| Sep 13, 2026 | 135 |
| Sep 20, 2026 | 120 |
| Sep 27, 2026 | 127 |
| Oct 4, 2026 | 109 |
| Oct 11, 2026 | 107 |
| Oct 18, 2026 | 131 |
| Oct 25, 2026 | 131 |
The Board ranks tools by four signals each week: new stars, new stars for the repo's size, added downloads and download growth beyond the market. How the ranking works.
ccusage alternatives
Other AI coding agents on the Board in the week of Oct 25–31, 2026, by momentum:
| Rank | Tool | Stars | Downloads/wk |
|---|---|---|---|
| #1 | CindyCindy is an open-source AI agent app for desktop and mobile that combines Claude Code, Codex and Pi across your connected devices. | 8.8k | – |
| #2 | OpenMausBotOpenMausBot is an open-source desktop chat app where each contact is a local Claude, Codex, or Grok CLI agent with its own computer. | 9.6k | – |
| #3 | OrcaOrca is a desktop agent development environment for running Claude Code, Codex, and other CLI coding agents in parallel, each in its own… | 111.7k | – |
| #4 | OpenBotOpenBot is an open-source, self-hosted template for AI coworkers that each get their own browser, files and granted tools, with every… | 9.1k | – |
| #5 | Agent ReachAgent Reach is a Python CLI that lets AI agents search and read platforms such as Twitter, Reddit, YouTube, GitHub, Bilibili and… | 107.2k | – |
| #6 | Skill RecorderSkill Recorder is a desktop app that records your on-screen work session and turns it into a reusable agent Skill or Automation. | 5.6k | – |
Recent ccusage releases
ccusage FAQ
Is ccusage free and open source?
ccusage's code is on GitHub (ccusage/ccusage), but the repository doesn't declare a standard open-source license. Check its license file before using it commercially.
How do I install ccusage?
Run npx ccusage@latest. The install section above has the other options from the project's README.
Is ccusage still maintained?
Yes. The ccusage/ccusage repository was last updated on Oct 21, 2026, and the latest release, v20.0.40 on GitHub, came out on Oct 21, 2026.
How popular is ccusage?
ccusage has 19.3k GitHub stars as of Nov 1, 2026. It gained 131 new stars in the week of Oct 25–31, 2026, against a 12-week average of 134 a week. Its main package had about 214.7k downloads that week, −16% against its own 4-week average. That made it #96 among AI coding agents on the Devtoolwatch Board.
What are the best alternatives to ccusage?
Other AI coding agents on the Devtoolwatch Board in the week of Oct 25–31, 2026, by momentum: Cindy (#1), OpenMausBot (#2), Orca (#3), OpenBot (#4), Agent Reach (#5). The alternatives table above has their numbers.
Is ccusage accurate?
ccusage reports token counts from local usage logs and estimates USD costs from model pricing data, with cache token accounting where available. Costs are estimates, not billing records. You can override pricing per model in ccusage.json.
Is ccusage safe to use?
ccusage reads local usage logs from supported coding agent CLIs without uploading your data. An --offline mode uses pre-cached pricing data without network connectivity.
Which coding agents does ccusage support?
ccusage supports 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, and ZCode.
Can ccusage group Claude Code usage by project?
ccusage groups Claude Code usage by project or instance with --instances, and filters to one project with --project.
Does ccusage work without internet access?
ccusage works offline with the --offline flag, which uses pre-cached pricing data.
Sources
ccusage README badge
Maintainers can show the tool's weekly Board rank in their README:
[](https://index.devtoolwatch.com/tools/ccusage/)How this page is made: Devtoolwatch writes each review from the project's README, releases, package metadata and website, with an AI model, then checks every claim against the source it cites and drops what the sources don't support. The numbers come from Devtoolwatch's daily GitHub snapshots, GitHub's stargazer history, and the npm and PyPI download APIs. Spotted an error? Email [email protected].