Changelog

Every version of Headroom, newest first. GitHub releases →

Dual display — menu bar now shows both meters: CC 10%·65% (session·weekly at a glance, no click needed)
macOS notifications — alerts at 70% and 90% when a window fills; configurable via ~/.claude/headroom-prefs.json
Pace forecast — "~2h 15m at pace" in the meter caption when your usage rate would fill the window before reset
Share Headroom… — native macOS share sheet (Messages, Mail, AirDrop, copy link)
Copy Stats — ⌘C copies your current session/week/context/model/cost to the clipboard as plain text
Open Claude Code — menu item to jump directly to Claude Code from the menu bar

v0.3.4June 2026 · current download

Context window, model name, session cost

Context window bar — a third meter showing how full your Claude Code context is before coherence degrades new
Active model — displays the current model (Sonnet 4.6, Opus, Fable) in the status line new
Session cost — live dollar spend for the current session, from the same data Claude Code tracks new
Universal binary: Apple Silicon + Intel, macOS 13+, ~267 KB
Signed with Developer ID + notarized by Apple

v0.3.2June 2026

Render.decide() is now the one place that decides title, tone, and live windows — used by both the menu bar GUI and the --print harness fix
Rolled-over windows (window elapsed) show "—" instead of stale data

v0.3.1June 2026

Hook-based data path — installs a tiny Claude Code statusline hook; Claude Code writes rate-limit data to ~/.claude/headroom-usage.json; Headroom reads it. No API polling, no credentials, no network. new
Same numbers as /usage inside Claude Code — because it's the same data source
Verified zero-network: nettop shows no outbound requests from Headroom

v0.2.xJune 2026

Session (5h) + weekly (7d) utilization in the menu bar, color-coded (calm → amber → red)
Reset countdowns in the dropdown
Launch at Login (SMAppService)
Polled Anthropic's usage endpoint — replaced in v0.3.1 with the hook approach