Headroom
A tiny desktop widget that keeps my Claude usage limits in view.
A tiny desktop widget that keeps my Claude plan limits in view: the 5-hour session and the weekly limit, each with a progress bar, a reset countdown, and a tick showing how much of the window has passed. Claude shows the same numbers in its settings; I check them often enough that I wanted them on my desktop instead.
What it does
- Live bars for every limit on the plan. New limits Anthropic adds (like per-model weekly caps) appear automatically.
- Menu bar readout and alerts when a limit crosses the thresholds I choose.
- How each window filled: a small chart per limit against an even-pace line, from readings kept on the computer.
- Where the week went: Claude Code vs. chats vs. Cowork, as reported by Anthropic.
- Model analytics from Claude Code's local logs: which models I actually use, replies and tokens per model, and activity by day. Nothing leaves the computer.
- API value: what that usage would have cost at pay-as-you-go API prices, priced reply by reply, next to the plan's monthly price.
- Busiest hours: a weekday-by-hour heatmap of when I work with Claude.
- Optional Hermes Agent source: if Hermes is installed, its usage is folded in (read-only, token counts only) with a switch and a source filter. Plain Claude users never see it.
- Works with work accounts: company SSO, Team, and Enterprise seats (including monthly spend limits). It explains itself plainly when an API key or cloud provider means there are no plan limits.
How it's built
- Tauri shell: a Rust core with a React UI in the system's own web view. The whole app is about 6 MB.
- The Rust side borrows Claude Code's existing sign-in read-only (macOS keychain, or a file on Windows/Linux). It never sees a password and never writes credentials.
- It reads the same usage endpoint behind Claude's own settings page. Because that endpoint is undocumented, the parser works from its generic list of limits and degrades gracefully.
- One UI, two windows (widget and details), plus a browser preview mode with sample data for design work and screenshots.
- Unit tests in Rust and TypeScript, run on macOS, Windows and Linux by GitHub Actions, which also builds the installers.