Skip to content

Headroom v0.3.4 — Context window %, model name, session cost in the dropdown

Choose a tag to compare

View all tags
@patwalls patwalls released this 11 Jun 02:18
· 122 commits to main since this release
v0.3.4
1f852d1

What's new

Three new rows in the dropdown — all reading data Claude Code was already writing to the hook file, but Headroom was ignoring until now:

  • Context window % — a third bar (calm/amber/red) showing how full your current context is. The question every deep-work session hits: "how full is my context before I lose coherence?" — now glanceable without opening a terminal.
  • Active model — shown next to the "Updated" timestamp: Sonnet 4.6 · Updated 10:39 PM
  • Session cost — Session cost: $X.XX in the dropdown, live per session. The first Claude Code menu bar tool to show real-time session spend.

All three hide themselves when Claude Code doesn't report the field (older versions), so the dropdown degrades gracefully.

How to update

brew upgrade --cask patwalls/tap/headroom

Or download from headroom.walls.sh.

Trust reminder

As always: zero network calls, no token, no Keychain, no analytics. The dropdown reads ~/.claude/headroom-usage.json — a local file Claude Code's own status line writes. Verify with nettop if you want.

Full changelog: context window % and model name added in Lap 25; session cost added in Lap 29. The complete build-in-public log is in VISION.md.

Assets 3
Loading