Updated

ccusage

An open-source (MIT) CLI that reads the local logs of Claude Code, Codex, OpenCode, Gemini CLI and other coding agents and reports token usage and estimated cost by day, week, month or session.

1 open-source project declares ccusage in their code; 1 maker's product we track uses it.

Open sourceSelf-hostableFree tier

Profile checked

Ask your AI about this, with this page as the source:ChatGPT ↗Claude ↗Perplexity ↗

How makers use ccusage

Makers' products we track use ccusage for parallel agents & Spec-Driven work (1).

What ccusage is used for

Parallel Agents & Spec-Driven Work · Session tools →Reports of token usage and estimated cost by day, month or session, read from the local logs of Claude Code, Codex, OpenCode, Gemini CLI and other agents.Trade-off: Costs are estimates from local logs, not your provider's bill.
Conductor23Superset8ccusage1Claude Squad0Nimbalyst0Makers' products on each, for parallel agents & Spec-Driven work

ccusage vs the alternatives makers chose

For parallel agents & Spec-Driven work, 1 of the 32 makers' products we know the choice of picked ccusage (3%), behind Conductor (72%).

OptionMakers' productsTeam of 5, 10,000 usersOpen source
Conductor23 72%$250/mo · ProNo
Superset8 25%—No
ccusage1 3%—Yes

For parallel agents & Spec-Driven work: how many of the 32 makers' products we know the parallel agents & Spec-Driven work of chose each option, and what each costs for a team of 5 with 10,000 users.

Costs are the cheapest plan that fits, from each vendor's pricing page, at the usage our stack planner assumes for a product with that many users. Free for: the users its cheapest plan a business can use stays free for.

When to use ccusage, and when not

Pick ccusage if

Something else fits better if

  • You use Claude Code or Codex on a Mac and want several tasks running at once, each in its own copy of the repo: Conductor or Superset.
  • You live in the terminal and want parallel agents with free, open-source tooling: Claude Squad.
  • You want the agent to write a spec and plan you approve before it codes, inside the agent you already use: Spec Kit or OpenSpec.
  • You want plans and specs written as tickets that any agent can then pick up: Traycer.
  • You want to follow and answer your agents from your phone while away from the desk: Happy.
From each decision's guide, written from what makers' products chose and why.

How ccusage itself is built

3 tools, from its own code, website and Product Hunt page.

Who uses it

1 makers' products, each linked to the source that shows it, and 1 open-source projects that declare it in their code. The best known on Product Hunt: whoburnedmore (92 followers).

The maker says so 1Declared in code 1How evidence is collected →

Open source: a project that declares ccusage as a dependency in its public code — verifiable, but not necessarily a live product.

Alternatives to ccusage

All alternatives by situation →

Questions makers ask about ccusage

What is ccusage used for?

An open-source (MIT) CLI that reads the local logs of Claude Code, Codex, OpenCode, Gemini CLI and other coding agents and reports token usage and estimated cost by day, week, month or session. Makers' products we track use it for parallel agents & Spec-Driven work (1).

What are the alternatives to ccusage?

For parallel agents & Spec-Driven work, the other options makers' products we track chose most are Conductor (23), Superset (8). Each alternative, with the situation it fits, is on the ccusage alternatives page.

When should you use ccusage?

You want to see what your agents' token usage would cost (parallel agents & Spec-Driven work). Something else fits better if: you use Claude Code or Codex on a Mac and want several tasks running at once, each in its own copy of the repo, pick Conductor or Superset; you live in the terminal and want parallel agents with free, open-source tooling, pick Claude Squad.

Is ccusage free?

Yes — it is free, open-source software.

Is ccusage open source or self-hostable?

Open source, and you can self-host it. source ↗

Can AI coding agents work with ccusage?

No llms.txt, official MCP server or CLI found yet.

Who uses ccusage?

1 makers' products we track, each with a source, and 1 open-source projects declare it in their code. The best known of them on Product Hunt: whoburnedmore (92 followers). source ↗