Headroom 1.6

What's new

This release is about efficiency: Headroom no longer spikes to gigabytes of memory for OpenCode users, and every provider scan now costs only as much as the data that changed.

• OpenCode: the token scan parsed whole message rows, up to hundreds of MB each, on every database write. It now reads just the head and tail of each row through SQLite blob I/O, and only rows written since the last scan.
• Codex: rollouts are tailed by byte offset instead of being re-read in full on every change.
• Grok, Codex and OpenCode state is kept in the ledger cache, so a relaunch re-reads nothing.
• Cold indexing is twice as fast, with a fixed-format parser for transcript timestamps.

Measured on one Mac against 1.5, two rounds each:

Scenario	1.5	1.6
OpenCode scan on each database change (every 10 s while OpenCode runs)	6.9 s, 5.1 GB peak	17 ms, no measurable memory
Cold index of 2.6 GB of Claude Code transcripts, CPU	21-24 s	9 s
Cold index, peak memory	4.4 GB	200 MB
Warm launch	4.8 s, 4.4 GB	1.8 s, 270 MB
Codex re-scan after one record appended to a 100 MB rollout	15 s	1 ms

The first launch after upgrading reads the OpenCode database once more to fill the cache (about 2.4 s, 400 MB on the same data), then stays at the 1.6 numbers.

Full changelog: v1.5...v1.6

Universal build for Apple Silicon and Intel, macOS 14 or newer. Signed and notarized by Apple.

Headroom 1.5

What's new

• Keep popover menus open on the first click
• Show extra Claude Code accounts as more bars in the Claude card
• Keep a healthy battery neutral in color mode

Full changelog: v1.4...v1.5

Universal build for Apple Silicon and Intel, macOS 14 or newer. Signed and notarized by Apple.

Headroom 1.4

What's new

• Automatic updates: Headroom now updates itself with Sparkle. It checks every 6 hours and shows Update to x.y in the dashboard footer; one click installs and relaunches. Check for Updates... is under Settings. Copies of 1.2 and older need this one update installed by hand; after that, updates are automatic.
• Codex support: plan limits (5h and weekly, or the monthly window on the free plan) as a dashboard card, menu bar gauge and hover panel, plus Codex token usage and cost in the totals. Works with the Codex CLI and with Codex in the ChatGPT desktop app.
• Colored menu bar (optional): Settings > Show in menu bar > Colors draws icons, graphs and gauges in the dashboard colors, with values turning orange and red near their limit. Off by default.
• Claude Code no longer shows an empty row or menu bar toggle when it is not set up.
• The token usage header no longer lists every provider; the rows below show them.

Full changelog: v1.2...v1.4

Universal build for Apple Silicon and Intel, macOS 14 or newer. Signed and notarized by Apple.

Headroom 1.2

What's new

• Show the app version and a release notes link in Settings
• Notarize and staple the app before packaging the DMG
• Sign with a Developer ID and notarize releases when secrets are set
• Show a link in the popover when a newer release is out
• Give OpenCode a color that stands apart from Sonnet
• Count OpenCode token usage in the totals
• Keep metric card titles on one line
• Show Claude usage on AWS Bedrock, and count Cowork sessions
• Build each architecture separately and merge with lipo
• Generate release notes from commits instead of install instructions

Full changelog: v1.1...v1.2

Universal build for Apple Silicon and Intel, macOS 14 or newer. Signed and notarized by Apple.

Headroom 1.1

What's new

• Add README banner and badges
• Add unit tests and CI test workflow
• Build release DMG when a release is published
• Add keep awake (Amphetamine-style sleep prevention)
• Use actions/checkout@v5 in release workflow

Full changelog: v1.0...v1.1

Universal build for Apple Silicon and Intel, macOS 14 or newer. Not notarized yet: on first launch, allow it under System Settings > Privacy & Security > Open Anyway.

Headroom 1.0

Install

1. Download Headroom-*.dmg below and open it.
2. Drag Headroom onto Applications.
3. Open Headroom from Applications. It lives in the menu bar, not the Dock.

Headroom is not notarized by Apple yet, so the first launch is blocked once. Open System Settings > Privacy & Security, scroll down and click Open Anyway next to the Headroom message. Alternatively run:

xattr -dr com.apple.quarantine /Applications/Headroom.app

Requires macOS 14 or newer. Universal build for Apple Silicon and Intel.

Claude Code limits and token usage appear when Claude Code is signed in; Grok appears when the Grok CLI is signed in (grok login).