Skip to content

v0.3.1 — zero network calls: reads Claude Code's own status line

Choose a tag to compare

View all tags
@patwalls patwalls released this 10 Jun 15:20
· 134 commits to main since this release
v0.3.1
b0baf8b

Download: headroom.walls.sh/download (signed & notarized, universal) · or brew install --cask patwalls/tap/headroom

The architecture flip

Headroom no longer polls Anthropic's usage API — it reads the official rate-limit numbers Claude Code itself renders in its status line, captured to a local file by a tiny auto-installed hook.

  • Zero network calls. No token, no Keychain access, no OAuth, no 429s — the entire old data layer is deleted
  • Auto-wires on first launch — no dialogs, no permission, chains any existing status line non-destructively (and "Repair Live Data" in the menu re-wires it any time)
  • Honest staleness — a window that has rolled over shows "—", never a wrong number
  • Smaller and simpler: ~590 lines, no dependencies, MIT

The data surface is two small files: Hook.swift (writes) and Usage.swift (reads).

Assets 2
Loading