Orpheus
Comparisons

Orpheus vs ccusage: live limits or local cost history

Short answer

Pick ccusage if you want free cost history for one machine: daily, monthly, session and 5-hour block reports built from Claude Code’s local logs.

Pick Orpheus if you run several Claude subscriptions across machines and want each account’s live weekly and 5-hour usage, a forecast to reset, and idle agents moved before one runs out.

On this page

Side by side

These two tools answer different questions. ccusage answers “what did I spend, and on what?” from the log files Claude Code writes on your machine.12 Orpheus is a hosted control room for Claude Code and Codex agents that puts every Claude subscription you pay for on one board, with each account's weekly and 5-hour usage, and can move idle agents to the account with the most room when you turn on Auto-move. If you want a history of tokens and dollars, ccusage is the tool. If you want to know how much room each account has left right now, across machines, that is the job Orpheus was built for.

ComparedOrpheusccusage
Usage and limits
What it measuresPercent of each account’s weekly and 5-hour limit used, read on the machineTokens and estimated cost, from local Claude Code logs
Cost history in dollarsNo, it shows limits, not spendYes, daily, weekly, monthly and per session
5-hour windowsYes, with the reset time per accountYes, the blocks report
Forecast to the next resetYes, what each account is on track for by resetNot described on its README
Several Claude accountsYes, one card per connected accountCombines the config folders you list into one report
Moves agents off an account that is running lowYes, idle agents, with 2 or more accountsNo, it is a reporting tool
Machines and agents
Agents it coversClaude Code, Codex and OpenCode sessions in tmuxClaude Code, Codex, OpenCode, Gemini CLI, GitHub Copilot CLI and others
Many machines in one viewYes, every connected Mac and Linux machineNo, it reads the machine it runs on
Works without tmuxNo, agents must run in tmuxYes
Use it from a phoneIn the phone’s browser. Native apps are in development.No, it is a terminal command
Setup and price
How you run itA small connector as a launchd or systemd user service, plus the hosted appnpx ccusage@latest, or bunx, pnpm or nix
Open sourceNoYes, MIT
FreeNo. 14-day trial, card required.Yes, no paid tier listed
Checked against each product's own pages and docs. See Sources.

Where ccusage is better

  • It is free and open source. ccusage is MIT licensed, with about 19.4k stars on GitHub.1 Orpheus costs $19 a month or more after a 14-day trial.
  • It shows what you spent. Daily, weekly, monthly and per-session reports put a dollar figure on tokens, and --json feeds them to scripts.1 Orpheus shows how much of each limit is used, not a spend history.
  • It needs no account or server. It reads local data and needs no account or hosted service.1 Orpheus’s connector sends usage numbers to the Orpheus server so they can appear on the board.
  • It covers more tools. Its README lists Codex, OpenCode, Gemini CLI, GitHub Copilot CLI and more than a dozen others.1 Orpheus shows Claude Code, Codex and OpenCode.

Where Orpheus is better

  • It sees the limit, not one machine’s logs. Usage on claude.ai, Claude Code and Claude Desktop counts toward the same limit.6 A log reader on one laptop only sees that laptop. Orpheus reads each login’s weekly and session percentage on the machine.
  • Every account and every machine on one board. Each connected Claude account gets a card with its weekly and 5-hour usage and reset time, and every agent session on every connected machine is in the same window.
  • A forecast, then action. Each card shows what the account is on track for by reset. With auto-move on, idle agents move to the account with the most room when an account reaches its threshold.
  • Agents, not only numbers. Live panes, broadcast to many sessions, and Asks: an agent’s question answered from any device, typed back into the session.

How they differ in practice

ccusage reads Claude Code’s project logs from ~/.config/claude/projects/ and ~/.claude/projects/ and combines both. Set CLAUDE_CONFIG_DIR to one folder or a comma-separated list and it reads those instead.2 Claude Code keeps those logs for 30 days by default, so older history needs a higher cleanupPeriodDays setting.2

The catch with any log reader is coverage. Anthropic’s own /usage breakdown has the same limit: it is “computed from local session history on this machine, so usage from other devices or claude.ai is not included.”4 If you also use claude.ai or a second machine on the same account, the logs undercount what the limit sees. Claude Code does expose the account’s own figures to statusline scripts as rate_limits.five_hour.used_percentage and rate_limits.seven_day.used_percentage, on Pro, Max and Ultra logins.5

Orpheus reads usage only when you turn it on. With "usage": true in the connector’s local policy file, it reads each login’s weekly and session percentage about once an hour on the machine and sends the numbers. It is off by default. That cadence suits a board and a forecast. For a minute-by-minute view on one machine, a local tool is quicker.

Claude-Code-Usage-Monitor

If what you want from ccusage is a live meter rather than reports, look at Claude-Code-Usage-Monitor. It describes itself as a “Real-time Claude Code usage monitor with predictions and warnings” and is MIT licensed, with about 8.8k GitHub stars and a README written for v4.0.0.3 It prefers Claude Code’s statusline rate_limits when they are fresh and falls back to labeled local estimates. With --data-paths or CLAUDE_CONFIG_DIR it scans several config folders and tags each by account, so separate accounts are not merged into one 5-hour window.3 It installs with uv tool install claude-monitor and needs Python 3.9 or later. Like ccusage, it runs on one machine and does not move agents.

Using them together

They do not get in each other’s way. ccusage only reads log files, and the Orpheus connector reads usage percentages and drives tmux sessions. A common split: ccusage for a monthly spend report, Orpheus for which account has room this afternoon.

Pricing

Orpheus $19 to $119 a month

By number of Claude accounts: $19 for 1, $29 for 2, $49 for 4, $89 for 8, $119 for 12. A year costs 10 times the monthly price. 14-day trial on every plan, card required, no free plan.

Orpheus pricing · As of

ccusage $0

Open source under MIT. Its README lists no price or paid tier. Run it with npx ccusage@latest.

ccusage on GitHub · As of

Claude-Code-Usage-Monitor $0

Open source under MIT. No paid tier listed. The dollar figures in its README are plan limits it tracks, not charges.

Usage Monitor on GitHub · As of

Prices change. If a figure here is out of date, the product's own pricing page is right.

Common questions

Does ccusage show my Claude usage limits?

It reports tokens and estimated cost from local logs, and its blocks report groups them into 5-hour windows. Its README does not describe reading the weekly percentage Anthropic shows in Settings, and the logs only cover the machine it runs on.

Does ccusage work with several Claude accounts?

It reads the folders in CLAUDE_CONFIG_DIR, which can be a comma-separated list, and combines them into one report. Claude-Code-Usage-Monitor tags each folder by account instead, so each account keeps its own 5-hour window.

Can I use ccusage and Orpheus together?

Yes. ccusage only reads log files, so it does not conflict with the Orpheus connector. You can keep ccusage for a spend history and use Orpheus for a live view of each account’s room.

Is Orpheus free?

No. Every plan has a 14-day trial with a card required and $0 charged today. After that it costs $19 a month for one Claude account, up to $119 for twelve. There is no free plan.

Sources

  1. ccusage, READMEGitHub, ryoppippi/ccusageChecked
  2. ccusage, Directory detectionccusage.comChecked
  3. Claude-Code-Usage-Monitor, READMEGitHub, Maciek-roboblogChecked
  4. Manage costs effectively (/usage)Claude Code docsChecked
  5. Customize your status lineClaude Code docsChecked
  6. How do usage and length limits work?Claude Help CenterChecked
  7. Orpheus pricinguseorpheus.comChecked