Ccusage

ccusage provides a command-line interface for inspecting usage data from coding assistants.

github.com/ryoppippi/ccusage
Ccusage homepage screenshot

About Ccusage

ccusage is a command-line tool that reads local usage data from coding agent CLIs and turns it into daily, weekly, monthly and session reports covering token usage and costs. It can report across all detected sources in one view or focus on a single source, and supports sources including Claude Code, Codex, OpenCode, Amp, Droid, Codebuff, Goose, Kilo, Kimi, Qwen, GitHub Copilot CLI, Gemini CLI, Grok Build CLI and others. Reports can be filtered by date range or recent period, grouped by agent, and emitted as JSON; the Claude Code-specific commands cover 5-hour billing windows and an optional status line for hooks that is labelled Beta.

Key features

  • Daily, weekly, monthly and session reports across detected coding agent CLIs
  • Source-focused reports such as ccusage claude daily or ccusage codex daily
  • JSON output, including per-agent and per-section breakdowns
  • Filters by --since/--until dates, --last periods and timezone
  • Claude Code 5-hour billing window view and Beta status line for hooks
  • Runs without global installation via npx, bunx, pnpm, Nix and PR preview builds
Best for: Developers who use one or more agentic coding CLIs and want to inspect token usage and costs from their local data.
Good for
  • Aggregates usage from many coding agent CLIs in a single report
  • Works from local usage data with no global installation required
  • Offers JSON output and date, timezone and project filters for scripting
Watch out for
  • Usage reporting depends on local usage data written by the agent CLIs
  • Billing-window and status line commands are limited to Claude Code
  • The status line command is marked Beta

Ccusage at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Open source
Not stated
Language
English
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

Ccusage alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

Pi

github.com/earendil-works/pi

Pi provides an agent toolkit with a unified model API, agent loop, terminal UI, and coding command line.

Open source
24 alternatives

Popular in AI Coding Tools

Well-known listings from the same topic.

All 176

Ccusage FAQ

How do I run ccusage without installing it globally?
Use a package runner such as npx ccusage@latest, bunx ccusage, pnpm dlx ccusage, pnpx ccusage, or nix run github:ccusage/ccusage -- daily.
Which coding agent CLIs are supported?
Sources include 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 I get machine-readable output or filter by date?
Yes. Reports support --json, and commands accept --since/--until dates or a --last period, plus options such as --timezone, --no-cost and --by-agent.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing