A visual ccusage alternative for Mac.
The open-source ccusage CLI is great when you want a terminal table of Claude Code tokens and API-equivalent costs. Dockspace (getdock.space, by JBer) puts that local spend and 13-week activity history into a live macOS Dock widget — and adds the exact 5-hour and 7-day plan limits, Codex and Antigravity quotas, and agent completion alerts.
ccusage, statusLine and Dockspace compared
| Capability | ccusage CLI | Custom statusLine | Dockspace (getdock.space) |
|---|---|---|---|
| Where it lives | Terminal command (npx ccusage) or terminal footer | Bottom line inside active Claude Code terminal | Liquid Glass widget bar in or beside your macOS Dock |
| 5-hour & 7-day plan limits | Estimates token blocks from local JSONL logs | Exact server percentages while terminal is open | Exact Claude Pro/Max percentages, pace mark & reset countdown |
| USD API-value spend & cache | Daily, monthly, session & model tables in CLI | Session cost if scripted by hand | Hover dashboard: Today, 7d, 30d & 13-week USD spend + cache share |
| Codex & Antigravity quotas | Separate CLI flags / log commands | Claude Code only | Claude Code, OpenAI Codex & Google Antigravity side by side |
| Multi-session agent alerts | None (run manually) | Current terminal tab only | Live AI Agents board + Tilo alert when a run finishes or waits |
| Data & privacy | Reads local ~/.claude JSONL files; no API key | Local shell hook in ~/.claude/settings.json | Reads local logs & statusLine on your Mac; no login or API key |
| Cost on macOS | Free and open source (MIT) | Free (DIY shell or Node script) | Free base bar (10 widgets); AI widgets in Pro from $19.99 once |
What ccusage solves well
Running npx ccusage@latest daily reads the JSONL transcripts under ~/.claude/projects and totals your input, output and prompt-cache tokens at API prices. If you only audit API-equivalent spend once a week in a terminal tab, ccusage is fast, local and free.
Two gaps show up during heavy daily coding: local token totals cannot tell you the exact percentage left on a Claude Pro or Max 5-hour block, and terminal tables disappear the moment you switch to your browser, simulator or editor.
Plan percentages on the tile, 13-week spend on hover
Dockspace gives you both numbers without typing a command. On the bar, Claude Usage shows the exact 5-hour session and 7-day weekly percentages reported by Claude Code, alongside the reset countdown.
Rest the pointer on the tile (or click it) to open the agent detail dashboard: session and weekly bars with a pace mark, local API-value USD spending and cache-read share across Today, 7 Days, 30 Days and 13 Weeks, plus a 13-week activity grid showing active days and peak token days. See how cache reads and 5-hour blocks work.
Claude, Codex and Antigravity in one bar
Most Mac developers now split work across more than one coding agent. Instead of juggling separate terminal tools for ccusage, Codex and IDE extensions, the AI Limits widget puts Claude Code, OpenAI Codex (including its 13-week spend from ~/.codex) and Google Antigravity side by side.
Beside it, AI Agents tracks live Claude Code, Codex, Cursor and Antigravity sessions from the last six hours, and Tilo — the Dock Buddy — speaks up when a background run finishes or waits for your approval.
Keeps your existing statusLine intact
In Settings › Buddy, one click links Dockspace to Claude Code’s statusLine in ~/.claude/settings.json. The helper saves the latest rate-limit percentages locally and chains right into your existing ccusage statusline or custom prompt script, so your terminal footer keeps working unchanged.
Nothing leaves your Mac: there is no account, no cloud proxy and no API key. And because Dockspace sits in or beside your Dock rather than the top bar, nothing hides behind the MacBook camera notch.
Free base bar, one-time Pro option
Dockspace for Mac (getdock.space) is free to download on macOS 14 Sonoma or later (Apple silicon and Intel), with ten widgets that stay free forever — including the Notch Clipboard Shelf and Disk Doctor.
Claude Usage, Codex Limits, AI Limits and the AI Agents board unlock with Dockspace Pro: One Year at $11.99/year, Lifetime from $19.99 once, or Forever Edition at $49.99, backed by a 14-day refund for any reason.
Common questions
- Can I keep using ccusage alongside Dockspace?
- Yes. Both tools read the local JSONL logs Claude Code already writes on your Mac, and Dockspace's one-click statusLine link chains cleanly before your existing statusLine script without overwriting it.
- Why do ccusage dollar totals and Claude Pro or Max plan percentages differ?
- ccusage prices cached and uncached tokens at public API rates from ~/.claude/projects logs, whereas Claude Pro and Max enforce sliding 5-hour and 7-day plan quotas on Anthropic's servers. Dockspace shows both: the exact plan percentages on the tile and API-equivalent USD spend on hover.
- Does Dockspace track OpenAI Codex and Google Antigravity too?
- Yes. The AI Limits tile puts Claude Code, OpenAI Codex (from ~/.codex logs) and Google Antigravity side by side, and the AI Agents tile watches active Claude Code, Codex, Cursor and Antigravity sessions.
Free to start. Yours to keep.
macOS 14 Sonoma or later · Apple silicon and Intel. Download the disk image and try ten widgets free forever, or unlock all 174 with Pro.