Like iStat Menus for your Claude subscription. A macOS menu bar app that shows your remaining headroom so you never get surprise-throttled mid-task.
Why This Exists
Claude Pro and Max subscribers have no passive way to see how much capacity they have left. The only options — /usage, the web dashboard, browser extensions — all interrupt your workflow. cc-hdrm polls the usage API in the background and puts the answer in your menu bar. Zero tokens spent, zero workflow interruption.
Features
At a Glance
- Menu bar headroom — always-visible percentage with color-coded severity (green → yellow → orange → red) and burn rate arrows (→ ↗ ⬆)
- One-click sign-in — OAuth via your browser, no API keys or config files
- Zero tokens spent — reads quota data, not the chat API
- Zero dependencies — pure Swift/SwiftUI
Popover Detail
- Ring gauges — 5-hour and 7-day headroom with animated fill and slope indicators
- Reset countdowns — relative ("resets in 2h 13m") and absolute ("at 4:52 PM")
- Extra usage tracking — dollar-based spend vs. limit with color-coded progress bar
- 24-hour sparkline — step-area chart of recent usage; click to open analytics
Analytics
- Historical charts — 24h, 7d, 30d, and All views with step-area and bar chart visualizations
- Subscription value breakdown — used vs. unused dollars prorated from your monthly plan
- Pattern detection — identifies overpaying, underpowering, usage decay, and suggests tier changes
- Self-benchmarking — cycle-over-cycle comparison across billing periods
Notifications
- Threshold alerts — configurable warnings at customizable headroom levels for both 5h and 7d windows
- Extra usage alerts — notifications at 50%, 75%, 90% of extra usage credit
- Smart re-arming — thresholds reset when headroom recovers
Data
- Local SQLite storage — every poll snapshot persisted, tiered rollups for efficient querying
- Configurable retention — 30 days to 5 years
- Configurable poll interval — 10s to 5 min
Install
Homebrew
brew install rajish/tap/cc-hdrm
Download
Grab the latest .dmg from GitHub Releases.
