Alternative
A ccusage alternative for Mac
ccusage is a free command line report. Edith's Usage keeps the same kind of numbers on screen: a dashboard, live limit rings, a menu bar readout and alerts.
Updated by Pulkit
The short answer
Keep ccusage if a free, open source report in the terminal is all you need. It runs straight from npx or bunx, reads local logs from a long list of coding agents, estimates cost from token counts and prints JSON for scripts.
Pick Edith if you want those numbers without running a command: Usage shows tokens and cost by day, model and project, live rate-limit rings for Claude, Codex, Cursor and Grok, a menu bar readout and alerts before you hit a cap. It is part of Edith, $35 once for one Mac.
You can use both. ccusage is quick for a one-off report or a server without a desktop, and Edith is the thing you glance at all day.
What ccusage does well
ccusage is MIT licensed and free. It has daily, weekly, monthly and session reports, a 5-hour blocks report for Claude Code billing windows, a compact status line for Claude Code, JSON output with --json and an offline mode that uses cached pricing. Its site lists supported sources from Claude Code and Codex to OpenCode, Amp, Gemini CLI, GitHub Copilot CLI, Cline, Antigravity and ZCode.
What Edith's Usage adds
Usage reads the same kind of local history and adds what a one-shot report cannot. Rate limits for Claude, Codex, Cursor and Grok show as live rings with reset countdowns and history. The menu bar readout comes in stacked, tagged or slash layouts and can be tinted by a time-aware risk model. Alerts are optional: a burn rate that would hit the cap before the reset, nearly capped, capped, the reset after a cap, and a morning outlook when a weekly window looks tight.
An activity heatmap colors each day by tokens or cost, and share cards export highlights, your activity calendar and your busiest day as images. With Machines, the same collector runs on your SSH servers and folds their agents into your totals, attributed to the right machine, repository and worktree.
Agents each one reads
Both read local logs from many agents, and neither list is a superset of the other. ccusage lists some Edith does not read, such as Cline, Antigravity and ZCode. Edith reads some that ccusage's list leaves out, such as Cursor's local chats and Command Code. Both cover Claude Code, Codex, OpenCode, Amp, Droid, Codebuff, Hermes, OpenClaw, Gemini, GitHub Copilot, Kimi, Qwen, Goose, Kilo, pi and Grok.
Price
Prices checked on from ccusage's own site or App Store listing. Edith's price is the one on the pricing page.
| App | How it is sold | Price | Runs on |
|---|---|---|---|
| Edith | One-time purchase | $35 once for one Mac, plus $7 for each additional Mac. Every extension and the updates that follow are included. 30-day refund. | macOS 14 or later on Apple silicon |
| ccusage | Free, open source | Free and MIT licensed. Run it with npx, bunx, pnpm dlx, pnpx or Nix. | Command line, run through npx, bunx, pnpm dlx or Nix |
Feature by feature
Each ccusage feature links to the page it is described on. Full means Edith does the same job, partial means it does part of it, and no means it does not.
| ccusage feature | ccusage | Edith | How Edith covers it |
|---|---|---|---|
| Daily, weekly, monthly and session reports | Full | Full | UsageEdith filters by range, model, project and agent, and ed usage daily prints a daily report. |
| Cost estimates from token counts | Full | Full | UsageTokens and spend by day, model and project. |
| Claude Code 5-hour windows | Full | Full | UsageEdith shows the 5-hour and weekly windows as live rings with reset countdowns. |
| JSON output for scripts | Full | Full | Usage ed usage commands return JSON with --json, and agents can call the same commands over MCP. |
| Status line text for Claude Code | Full | No | UsageEdith hooks Claude Code's status line only to read live limits, and any status line you had keeps its output. |
| Cline, Antigravity and ZCode logs | Full | No | Edith does not read these agents. |
| Runs with no install | Full | No | Edith is a Mac app you install and license. |
When to keep ccusage
- Free to use, with its source on GitHub under the MIT license.
- It runs anywhere you can run npx, bunx, pnpm dlx or Nix, with nothing to install.
- It reads some agents Edith does not, such as Cline, Antigravity and ZCode.
- It prints a compact status line inside Claude Code.
- An offline mode uses cached pricing data.
What Edith does not do
- It is not free: Usage comes with Edith at $35 once for one Mac.
- It runs on Macs only, with macOS 14 or later on Apple silicon. Linux servers are covered only as SSH machines feeding a Mac.
- No support for Cline, Antigravity or ZCode logs.
- No status line text of its own inside Claude Code; the readout lives in the menu bar.
- Edith checks its license online and asks to reconnect after 3 days offline.
Switching from ccusage
- 1
Install Edith and turn on Usage
Install Usage from Extensions in Edith, or run
ed extensions install usage. - 2
Collect your history
Open Usage and press refresh. The first run reads your whole history and can take a few minutes.
- 3
Connect live Claude limits
Run
ed usage statusline installso Claude Code passes its 5-hour and weekly limits to Edith while you work. A status line you already had keeps running. - 4
Pick what the menu bar shows and when to alert
Choose the windows shown in the menu bar, the warning thresholds, and which alerts you want in the Usage settings.
- 5
Keep ccusage for scripts if you like
ccusage keeps working alongside Edith. Or move scripts to
ed usage summaryanded usage limits, which print JSON with--jsonand are also available to agents through the MCP server. - 6
Decide within the refund window
Use Edith and ccusage side by side for a while. If Edith turns out not to replace ccusage for you, email within 30 days of buying for a full refund.
Frequently asked questions
Is ccusage free?
Yes. ccusage is open source under the MIT license, and you can run it with npx, bunx, pnpm dlx or Nix.
Does Edith read my prompts or code?
No. Usage reads token counts, models and timestamps from the history your agents keep on your Mac.
Which rate limits does Edith show?
Claude, Codex, Cursor and Grok. Each shows how much of the window you have used and when it resets, in the app and optionally in the menu bar.
Can Edith total usage from my servers?
Yes. Add a server in Machines and Usage runs the same collector there over SSH, then folds its agents into your totals with the machine attributed.
Does Edith work without a menu bar app?
Yes. The numbers are also available as commands such as ed usage summary, ed usage daily and ed usage limits, which print JSON with --json, so you can script them like ccusage.
Sources
Every ccusage fact on this page comes from these pages, checked on . Edith is made by the author of this page. Read how we compare for the method and how often facts are rechecked.
Updated
More comparisons
- Amphetamine Alternative: Keep Mac Awake for AgentsAn Amphetamine alternative for Mac: keep a MacBook running with the lid closed while agents and builds finish, with timers, battery floors, CLI and MCP.
- Edith vs Raycast: One-Time Mac Toolkit ComparedEdith vs Raycast on Mac: a free launcher with paid AI plans, or one payment for a launcher plus agent usage, MCP control and Mac utilities.
Get Edith.
From $35 once. No subscription. No account.
Needs a license key · macOS 14 or later on Apple silicon · 6.4 MB