Shows 5h and 7d headroom as a percentage with color-coded thresholds. Burn rate arrows (→ ↗ ⬆) so you know if you're coasting or sprinting. 24h sparkline shows your usage sawtooth pattern. Notifications at 20% and 5% before you hit the wall.
Reads your existing Claude Code OAuth credentials from Keychain (zero config). Pure Swift, no dependencies, polls the quota API (not chat API, so no tokens wasted).
brew install rajish/tap/cc-hdrm
Coming next: full analytics window with historical charts and a breakdown showing what you actually used vs. what the weekly limit blocked vs. what you genuinely left on the table. Based on clever reverse engineering carried out by she-llac in https://she-llac.com/claude-limits
rajish•1h ago
Polls the same API endpoint Claude Code uses to check your quota. Reads OAuth tokens directly from macOS Keychain (written by Claude Code on login). Token refresh is automatic — handles the full OAuth flow in the background.
Historical data is stored locally in SQLite for the sparkline. The sawtooth pattern is interesting — you can clearly see the 5h window resets.
What I'm working on next: a full analytics window with a three-band breakdown of your headroom — separating what you actually consumed, what the weekly limit blocked (not your fault), and what you genuinely left on the table. Turns out a lot of "wasted" capacity was never really available to you.
Built the whole thing using the BMAD methodology with Claude Code as the dev agent. Happy to answer questions about either the app or the process.