# ccusage review

> ccusage is a local CLI that analyzes token usage and estimated costs from coding agent CLIs like Claude Code, Codex, and Gemini CLI.

Devtoolwatch Board, the week of Oct 25–31, 2026. Canonical page: https://index.devtoolwatch.com/tools/ccusage/

## 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.

## ccusage at a glance

- **Category:** [Coding agents](https://index.devtoolwatch.com/categories/coding-agents/)
- **Maintained by:** ccusage (organization, [@ccusage](https://github.com/ccusage) on GitHub)
- **Language:** Rust, Nix, TypeScript
- **Repository:** [github.com/ccusage/ccusage](https://github.com/ccusage/ccusage)
- **Website:** [ccusage.com](https://ccusage.com/)
- **npm package:** [ccusage](https://www.npmjs.com/package/ccusage) 20.0.40
- **Latest release:** [v20.0.40](https://github.com/ccusage/ccusage/releases/tag/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 ccusage

**With npx**

```
npx ccusage@latest
```

**With bunx**

```
bunx ccusage
```

**With Nix**

```
nix run github:ccusage/ccusage -- daily
```

### Requirements

- 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

1. Run `npx ccusage@latest` to see a daily report of all detected coding agent CLI usage.
2. Narrow to one source with a focused command such as `ccusage claude daily` or `ccusage codex daily`.
3. Use `--last 1` on a daily, weekly, or monthly report to see today, this week, or this month.
4. 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

- 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.

## Usage data (the week of Oct 25–31, 2026)

- Board rank: #327 overall, #96 in Coding agents, momentum score 26
- Downloads that week: 214.7k (−16% vs 4-week average)
- New GitHub stars per week (last 12 weeks): Aug 9: 154; Aug 16: 169; Aug 23: 110; Aug 30: 162; Sep 6: 148; Sep 13: 135; Sep 20: 120; Sep 27: 127; Oct 4: 109; Oct 11: 107; Oct 18: 131; Oct 25: 131

## ccusage alternatives

| Rank | Tool | Stars | Downloads/wk |
|---|---|---|---|
| #1 | [Cindy](https://index.devtoolwatch.com/tools/makecindy-cindy/) | 8.8k | – |
| #2 | [OpenMausBot](https://index.devtoolwatch.com/tools/milind-soni-openmausbot/) | 9.6k | – |
| #3 | [Orca](https://index.devtoolwatch.com/tools/stablyai-orca/) | 111.7k | – |
| #4 | [OpenBot](https://index.devtoolwatch.com/tools/copilotkit-openbot/) | 9.1k | – |
| #5 | [Agent Reach](https://index.devtoolwatch.com/tools/panniantong-agent-reach/) | 107.2k | – |
| #6 | [Skill Recorder](https://index.devtoolwatch.com/tools/microsoft-skill-recorder/) | 5.6k | – |

## 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

1. [ccusage/ccusage on GitHub](https://github.com/ccusage/ccusage)
2. [ccusage README](https://github.com/ccusage/ccusage/blob/main/README.md)
3. [ccusage on npm](https://www.npmjs.com/package/ccusage)
4. [ccusage website](https://ccusage.com/)
5. [Release v20.0.40 (Oct 21, 2026)](https://github.com/ccusage/ccusage/releases/tag/v20.0.40)
6. [Release v20.0.39 (Oct 21, 2026)](https://github.com/ccusage/ccusage/releases/tag/v20.0.39)
7. [Release v20.0.38 (Oct 21, 2026)](https://github.com/ccusage/ccusage/releases/tag/v20.0.38)
8. [Devtoolwatch Board, the week of Oct 25–31, 2026](https://index.devtoolwatch.com/)