The full guide
ccusage alternatives, step by step
Keep ccusage for a report when you ask for one. For something that stays open, pick tokscale for a terminal view of 64 clients, CodeBurn for a desktop and menu-bar app with a ten-year daily record, CodexBar for plan limits in the Mac menu bar, or Caprock for every session on the machine, live, with cost per repository and history kept past Claude Code's 30-day cleanup. Read 15 November 2026.
What ccusage does well
ccusage reads the JSON lines Claude Code, Codex and 17 other agents already write on your disk and prints a table of tokens and dollars. It runs and exits. Most people who look for an alternative want something it chose not to be: a view that stays open, a record that outlives the files, or an app.
- Nothing to install or leave running:
npx ccusage@latest,bunx ccusageorpnpm dlx ccusage, and it exits. - 19 sources in one report: Claude Code, Codex, OpenCode, Amp, Droid, Cline, Hermes Agent, Goose, Kilo, Qwen, Copilot CLI, Gemini CLI, Antigravity, Grok Build CLI and more.
- Daily, weekly, monthly and per-session tables, Claude Code's five-hour blocks,
--jsonfor scripts, and per-project grouping with--instances. - Works offline with cached LiteLLM prices (
--offline), and lets you override a model's price inccusage.json. - MIT, about 19,400 GitHub stars, a release a few days apart (v20.0.51 on 14 November 2026).
Why people look for a ccusage alternative
- No live view: “The
blocks --livemonitor feature has been removed in v18.0.0.” Its real-time answer is a status-line command, marked Beta. - The five-hour blocks are worked out from your transcripts; it does not read Claude's own plan percentage.
- No record of its own: “Claude Code can retain logs for only 30 days by default”, so a report shows what is still on disk.
- Codex support is marked Beta: “Codex log support is experimental while the Codex CLI log format continues to evolve.”
- A table in a terminal, not an app: no window, no menu bar, no alerts.
Before installing anything: inside a session, Claude Code's own /usage (/cost is an alias) shows the session's tokens, a cost estimate at list price and, on Pro, Max and Ultra, the plan's usage bars; its breakdown covers this machine's last 24 hours or 7 days. More in how to check Claude Code usage.
ccusage alternatives side by side
| Tool | Runs as | Live or on demand | Plan limits | Agents read | Past the 30-day cleanup | Desktop OS | Licence, price |
|---|---|---|---|---|---|---|---|
| ccusage | CLI, via npx or bunx | On demand; status line (beta) | 5-hour blocks, estimated | 19 sources | What is still on disk | macOS, Linux, Windows | MIT, free |
| tokscale | Terminal UI, via npx or bunx | On demand, 10 views; optional auto-refresh | 5-hour and weekly, as the provider reports them | 64 clients | What is on disk; an opt-in recovery ledger | Wherever Node.js or Bun runs | MIT (web app AGPL-3.0), free |
| CodeBurn | CLI, desktop app, menu bar or tray | Live in the menu bar and tray | 5-hour and weekly, from each provider | 42 integrations | Daily totals for ten years; session detail goes | macOS, Windows, Linux | MIT, free |
| Caprock | Desktop app, or a headless daemon | Live | Claude 5-hour and 7-day; Codex | 6 agents | Kept, every session searchable | macOS, Windows, Linux | Apache-2.0, free; optional Premium |
| CodexBar | Menu bar app; CLI on Linux | Live | Session and weekly windows, per provider | 114 providers; cost scan for Claude and Codex | Not in its README | macOS 14+, Linux; Windows through third-party ports | MIT, free |
| Claude-Code-Usage-Monitor | Terminal UI (claude-monitor) | Live | 5-hour; weekly from the status line | Claude Code | Opt-in warehouse, 365 days | macOS, Linux, Windows | MIT, free |
| Splitrail | CLI, local web dashboard, VS Code extension | Real-time | Not in its README | 14 agents and extensions | Not in its README; optional cloud upload | Binaries per platform | MIT, free; Splitrail Cloud optional |
tokscale: Terminal UI, run through npx or bunx
The closest in shape to ccusage: one command, no install, but an interactive view and the live plan quotas. MIT (its web app AGPL-3.0), free. github.com/junhoyeo/tokscale, README and release v4.23.0, read 15 November 2026.
- An interactive terminal UI with 10 views: Overview, Usage, Models, Daily, Hourly, Monthly, Sessions, Projects, Stats and Agents.
- 64 clients in its table, Claude Code and Codex CLI among them.
- Claude's five-hour, weekly and per-model quotas as Anthropic reports them: it “calls each provider's own quota endpoint”.
- An opt-in ledger that keeps usage you recovered from an export, so it can show past what Claude Code deleted.
Limits:
- A view you open, like ccusage, though it can auto-refresh (
Shift+R); not a feed of what a session is doing. tokscale submitsends your totals to its public leaderboard, and autosubmit can schedule it; nothing goes unless you run or schedule it.- A status-line command is not in its README.
- Some clients, Cursor, Trae and Capy among them, are synced from the vendor's API rather than read from local files.
npx tokscale@latest npx tokscale@latest usage
CodeBurn: CLI and desktop app, with a menu bar and tray
ccusage's reports in an app on every desktop system, with today's spend beside the clock and a record that outlives the transcripts. MIT, free, no paid tier. github.com/getagentseal/codeburn, README and release v0.9.28, read 15 November 2026.
- A desktop app on macOS, Windows and Linux; today's spend in the macOS menu bar, the Windows tray or a GNOME panel.
- “A durable daily history under
~/.cache/codeburn/”: each day's cost, tokens and per-project and per-model split, for ten years. codeburn quotareads the live five-hour and weekly windows from the tools you are signed in to.- Guard, opt-in: Claude Code hooks that warn a session past $5 and stop it at $15, limits you set.
- An MCP server, so an agent can ask it about your usage.
Limits:
- The desktop app, menu bar and tray send an anonymous daily usage report, on by default; Settings turns it off. The CLI sends nothing.
- Per-session detail still goes with the transcript; only the daily totals are kept.
- Needs Node.js 22.15 or later for the CLI.
- Its README says 42 integrations and its repository description 37 tools.
npx codeburn npx codeburn quota
Caprock: Desktop app over a background service, or the service alone
Every session on the machine as it runs, whichever terminal started it, with cost per repository and a record that outlasts the 30-day cleanup. Apache-2.0, free; optional Premium, $30 a year or $100 once. github.com/dspv/caprock, README at master (v0.175.2), read 15 November 2026.
- Live: a Claude Code session you start in your own terminal shows up as it runs, with what it is doing and what it has cost.
- Cost per repository, and per service inside a monorepo, for today, 7 days or 30 days, and lifetime; each pull request with what the agents spent on it.
- Its own database: a session stays on its screens after Claude Code deletes the transcript, and what the agent wrote stays searchable.
- Claude's five-hour and seven-day windows and Codex's, with a warning before the limit, once its status line is installed.
- In a terminal too:
caprock reportprints the total at list price (--markdown,--json), andcaprock exportwrites every turn or session as TSV, CSV or JSON lines. - It runs the agents as well: Claude Code, Codex, OpenCode and Gemini CLI in terminal tabs per project.
Limits:
- Fewer agents than ccusage: Claude Code, Codex, OpenCode, DeepSeek Harness and Hermes Agent, and Gemini CLI only in the sessions it starts. No Cursor, Copilot or Amp.
- Not a one-off command: a background service runs, and it adds a hook and a status line to Claude Code's settings, asking first.
caprock reportreads from that service. - Every dollar Caprock shows is an estimate at API list price, as Claude Code's own /usage is: not a bill, and on a flat plan not money saved.
- OpenCode and Hermes Agent report their own figures; Caprock passes them through.
CodexBar: Mac menu bar app; a CLI and a Qt app on Linux
Plan limits and their reset times for every provider you pay for, always in view; it says it was “inspired by ccusage”. MIT, free. github.com/steipete/CodexBar, README and release v0.84.0, read 15 November 2026.
- Live in the menu bar: each provider's windows and when each resets.
- 114 providers in its README: Claude, Codex, Cursor, Gemini, Copilot and many more, one icon each or merged.
- A cost scan of Claude Code and Codex from local files (
codexbar cost). - Reuses the sign-ins you already have; browser cookies only when you opt in.
Limits:
- macOS 14 or later; Linux has a Qt 6 app; Windows only through third-party ports.
- Its cost scan covers Claude and Codex, not the 19 sources ccusage reads.
- Built around limits, not a history of sessions or projects.
brew install --cask codexbar
Claude-Code-Usage-Monitor: Live terminal UI, the claude-monitor command
The live five-hour window ccusage removed in v18, in a terminal, with the official figure. MIT, free. github.com/Maciek-roboblog/Claude-Code-Usage-Monitor, README, PyPI and release v4.0.0, read 15 November 2026.
- A live view of the current window: tokens, messages, cost, burn rate and when you will run out.
- With
--statuslineit captures Claude Code's officialrate_limits; weekly figures “render only from official statusline data”. - An opt-in local warehouse that “survives Claude's 30-day cleanup”, 365 days by default.
- Output as rich, JSON, text or CSV;
--oncefor scripts.
Limits:
- Claude Code only; no Codex.
- Its last release, v4.0.0, and last commit are from 27 June 2026.
- Needs Python 3.9 or later, and its terminal open to stay live.
uv tool install claude-monitor claude-monitor
Splitrail: CLI, a local web dashboard and a VS Code extension
A real-time tracker with a dashboard in your browser on 127.0.0.1, and an optional cloud for several machines. MIT, free; Splitrail Cloud optional. github.com/Piebald-AI/splitrail, README and release v3.13.0, read 15 November 2026.
splitrail webserves a dashboard on 127.0.0.1 only: cost, tokens, replies and sessions by tool, model and project, with CSV export.- Sessions with active time, tool calls, file reads and edits.
- An MCP server, and an opt-in OpenTelemetry export that never includes prompts or tool output.
- Optional upload to Splitrail Cloud “for safe-keeping and cross-machine usage aggregation”; off unless you turn it on.
Limits:
- Plan limits are not in its README.
- A binary from its Releases page; no npx.
- “Costs use public API prices and may differ from subscription spending.”
Also named in "ccusage alternatives" lists
- Claude Usage Tracker — a macOS menu bar app (MIT, v3.4.0) for Claude's five-hour, weekly and per-model limits, Console spend and Codex profiles. It reads limits from claude.ai and Anthropic's API rather than cost from your transcripts, so it answers the limits half of what ccusage does.
- ccstatusline — a formatter for Claude Code's status line, not a usage report.
Which ccusage alternative to pick
Pick by the question. They all read the same files on disk, so two can run side by side, and ccusage stays one npx away.
- ccusage — a report now and then, nothing installed.
- tokscale — the same, interactive, with live plan quotas.
- CodeBurn — an app and a menu bar on Windows or Linux too.
- Caprock — every session on the machine, live, cost per repository, history kept.
- CodexBar — limits for every provider you pay for, in the Mac menu bar.
- Claude-Code-Usage-Monitor — the live five-hour window in a terminal, Claude Code only.
- Splitrail — a local web dashboard, or one total across machines.
/usagein Claude Code, built in — today's figure inside a session.
Choosing a usage monitor with no tool at the centre: Claude Code usage monitors. Where the transcripts live and how to keep them past 30 days: Claude Code history.
Questions people ask
- What is the best alternative to ccusage?
- It depends on what ccusage does not give you. tokscale is the closest in shape, a terminal view through npx with live plan quotas; CodeBurn adds a desktop app and a ten-year daily record; Caprock records every session on the machine live, with cost per repository, past the 30-day cleanup; CodexBar keeps every provider's limits in the Mac menu bar.
- Does ccusage still have a live monitor?
- No. Its docs say the blocks --live monitor was removed in v18.0.0; for real-time figures it offers ccusage statusline, marked Beta. Claude-Code-Usage-Monitor, CodeBurn's menu bar, CodexBar and Caprock stay open and update live.
- Is there a ccusage alternative with a GUI?
- Yes. CodeBurn has a desktop app on macOS, Windows and Linux; Caprock is a desktop app on all three; CodexBar is a Mac menu bar app with a Qt app on Linux; Splitrail serves a local web dashboard.
- Which ccusage alternative keeps history past 30 days?
- Claude Code deletes transcripts after 30 days by default. Caprock keeps every session it read, searchable; CodeBurn keeps daily totals for ten years; Claude-Code-Usage-Monitor has an opt-in warehouse of 365 days. ccusage and tokscale show what is still on disk.
- Do these tools show my real Claude bill?
- No. They price tokens at API list price, which on Pro or Max is not what you pay. On an API key the Claude Console's usage page is the bill.
Sources
- ccusage — README, docs and release v20.0.51 (14 November 2026), read 15 November 2026
- ccusage docs — live monitoring (blocks --live removed in v18.0.0), read 15 November 2026
- ccusage docs — statusline integration (Beta), read 15 November 2026
- ccusage docs — Codex data source (Beta), read 15 November 2026
- tokscale — README and release v4.23.0 (15 November 2026), read 15 November 2026
- CodeBurn — README and release v0.9.28 (8 November 2026), read 15 November 2026
- CodexBar — README and release v0.84.0 (7 November 2026), read 15 November 2026
- Claude-Code-Usage-Monitor — README, PyPI and release v4.0.0 (27 June 2026), read 15 November 2026
- Splitrail — README and release v3.13.0 (9 November 2026), read 15 November 2026
- Claude Usage Tracker — README and release v3.4.0 (13 November 2026), read 15 November 2026
- Claude Code docs — Manage costs effectively (/usage, /cost an alias of it), read 15 November 2026
- Claude Code docs — Customize your status line (rate_limits), read 15 November 2026
- Claude Code docs — Settings (cleanupPeriodDays)
- Caprock — README at master (v0.175.2): agents read, cost per repository, plan windows, history kept, caprock report, caprock export, Premium; read 15 November 2026
- Caprock — CHANGELOG (0.175.2, 12 November 2026)
- Caprock docs — using the desktop app (docs/app.md)
Try it
The record of every coding agent you run, the sessions it did not start included. Free, open source; nothing leaves your machine.
Caprock is a desktop app: it installs on your computer, not your phone.
Or email yourself the link:
macOS, Windows and Linux. Your phone pairs with it by QR code. Install options →
Notarized by Apple. One file for Apple silicon and Intel, macOS 13 or later.
Windows 10 22H2 or later, x64. Windows may ask once whether to run it: click More info, then Run anyway.
Paste it into Claude Code, Codex or any coding agent.
See what it says ▾
Install the Caprock desktop app for me. It is open source (Apache-2.0), a local app for my coding agents: https://github.com/dspv/caprock What the install does and how to remove it: https://github.com/dspv/caprock/blob/master/docs/install-agent.md Run the install script for my system: https://caprock.dev/mac.sh, /win.ps1 or /linux.sh. Read it before you run it if you like. Leave my Claude Code settings alone; the app asks me itself. Tell me when it's open.
Or run it yourself:
Paste in Terminal: it installs Caprock and opens it.Or with Homebrew: brew install --cask dspv/tap/caprock-app
Or run it yourself:
Paste in PowerShell: it installs Caprock for you and opens it.
Or run it yourself:
Paste in a terminal: it installs Caprock for you, no sudo. Or download the AppImage