A Claude usage tracker for Mac.
You can watch your Claude Code usage on a Mac in five ways: typing /usage, scripting your terminal statusLine, running ccusage on local logs, adding a menu bar icon, or placing a live widget beside your Dock. Here is what each option shows — and where Dockspace (getdock.space, by JBer) fits.
Mac Claude trackers side by side
| Capability | Dockspace (getdock.space) | ccusage CLI | ClaudeBar & menu bar apps |
|---|---|---|---|
| Always in view | Yes — sits in or beside your macOS Dock (zero notch crowding) | No — run npx ccusage in a terminal when you want a table | Only if the MacBook camera notch has room left in the top bar |
| Exact 5h & 7d plan limits | Yes — live Claude Pro/Max percentages, pace mark & reset countdown | Estimates token blocks from local logs | Yes, usually via Keychain session cookies or local status hooks |
| USD spend & cache history | Hover panel: Today, 7d, 30d & 13-week USD API value + cache share | Daily, monthly & per-model CLI breakdown | Varies; most menu bar meters show current % only |
| Multi-agent support | Claude Code, OpenAI Codex & Google Antigravity + live session board | CLI flags / community forks | Single-service or select coding tools |
| Auth & privacy | Reads local logs & statusLine script; no login or Keychain token read | Reads local ~/.claude JSONL files; no API key | Often reads browser cookies or Keychain OAuth tokens |
Five ways to see your usage
- The /usage command. Type it inside an active Claude Code prompt to inspect your current 5-hour and weekly allowances. Exact, but manual.
- The Claude Code statusLine. A shell hook in
~/.claude/settings.jsonpinned to the bottom of your terminal. Always visible inside Terminal, invisible everywhere else. - A local log reader such as open-source
ccusage. Great for terminal cost tables, though it calculates API-equivalent spend rather than live Pro/Max plan percentages. Read the full ccusage vs Dockspace breakdown. - A menu bar utility (such as ClaudeBar, ClaudeUsageBar or SessionWatcher). Sits at the top of the screen, where notched MacBooks silently hide overflow icons behind the camera cutout.
- A widget bar in the Dock row. Sits where you already look for your apps, with room for live rings, reset times and multi-agent status.
Live limits plus a 13-week spend dashboard
Claude Usage shows your exact 5-hour session and 7-day weekly percentages as reported by Claude Code, plus the countdown until each window resets. See how the 5-hour and weekly limits work.
Rest the pointer on the tile — or click it — to open the hover detail dashboard: session and weekly bars with a pace mark, local USD API-value spending and prompt-cache share across Today, 7 Days, 30 Days and 13 Weeks, and a 13-week activity grid with active days and peak volume.
Coding across multiple tools? AI Limits puts Claude Code, OpenAI Codex and Google Antigravity in a single tile, while AI Agents watches active Claude Code, Codex, Cursor and Antigravity sessions and notifies you when one finishes.
One-click statusLine link, zero credentials
In Settings › Buddy, one click connects Dockspace to Claude Code’s status line. A tiny local script records the latest percentages, then chains into your existing status line so your terminal setup stays untouched. Until you connect it, Dockspace estimates 5-hour window usage from local logs.
Dockspace reads only what your coding tools already write on disk — never your Keychain tokens, prompts or account credentials. Nothing about your agents leaves your Mac. See the privacy page.
What it costs
Dockspace is free to start on macOS 14 Sonoma or later (Apple silicon and Intel), with ten widgets that stay free forever. Claude Usage, Codex Limits, AI Limits and the AI Agents board are part of Dockspace Pro: One Year at $11.99/year, Lifetime from $19.99 once, or Forever Edition at $49.99, with a 14-day refund for any reason.
Common questions
- Does Dockspace read my macOS Keychain or require my Anthropic login?
- No. Dockspace never reads browser cookies or Keychain credentials and needs no API key. One click in Settings › Buddy links a small local script into Claude Code's statusLine in ~/.claude/settings.json while preserving your existing terminal status line.
- Can I see both my Claude subscription percentage and API-equivalent dollar spend?
- Yes. The Claude Usage tile displays your live 5-hour session and 7-day weekly percentages with reset countdowns, and hovering or clicking the tile opens a 13-week activity and API-value USD spending dashboard (Today, 7 Days, 30 Days and 13 Weeks) with prompt-cache share.
- How is Dockspace different from ccusage or ClaudeBar?
- ccusage prints token and cost tables on demand in Terminal, while menu bar meters like ClaudeBar or ClaudeUsageBar sit in the top bar where notched MacBooks hide extra icons. Dockspace combines live Pro/Max plan percentages, 13-week USD spend, Codex and Antigravity quotas, and agent alerts in the notch-free Dock row.
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.