Native macOS menu bar

Know exactly how much AI you have left.

Headroom shows how much of your Codex and Claude Code rate limits remains, when each window resets, and warns you before a long run dies at 99%.

Download for macOS See how it works

macOS 14+ · Apple Silicon & Intel · no account, no telemetry

38% Thu 09:41
◔ Headroom 2s ago
✳ Claude Code MAX
Session (5h)62%left
resets in 1h 11m · 11:14
Week (Fable)19%left
resets in 4d 8h · Mon 11:00
{} Codex PLUS
Session (5h)66%left
resets in 2h 39m · 12:42
Week42%left
resets in 3d 4h · Sun 15:02

This is a live replica: hover the rows, hit refresh. The real app is pixel-identical.

How it works

Official endpoints. The logins you already have. Nothing else.

No scraping, no proxies, no API keys to paste. Headroom reads the same usage data the vendors' own tools read, with the credentials your CLIs already keep on this Mac.

01

Every window, one glance

Session and weekly windows for Codex and Claude Code, including per-model weekly caps. Each gauge shows percent left, threshold ticks, and the exact reset time.

02

The tightest limit lives in your menu bar

Headroom finds your most binding window and pins its percentage next to the clock. It turns orange at 75% used and red at 90%, so the wall never surprises you.

03

A HUD that floats over your editor

A draggable always-on-top panel with every gauge, visible in every Space. Toggle it from anywhere with ⌃⌥J, snap it to any corner, and watch the bars move while your agents run.

Headroom floating HUD with per-window gauges
04

Warned before the wall, not after

Native notifications at thresholds you choose. Start the long agent run only when you know it can finish.

Claude Code: heads up
Week (Fable) is 81% used. Resets Thursday 16:43.
Codex: limit almost reached
Session (5h) is 92% used. Resets at 10:23.
05

A health check for your terminal

The same engine ships as a command: Headroom --check prints every window in plain text. Perfect for scripts, tmux status lines, or a quick look over SSH.

Privacy

Local-first is not a feature. It is the architecture.

  • Credentials never move. Headroom reads the tokens your CLIs already store and talks only to the vendors' own usage endpoints.
  • Zero telemetry. No analytics SDK, no crash reporter, no account, no server of ours in the middle.
  • Auditable. A small native Swift app you can read in an afternoon. No Electron, no bundled browser.

Pricing

Open source. Pay for the convenience.

The code is on GitHub under MIT: build it yourself for free, forever. Or grab the ready-to-run build and support the project.

Source

For people who read their tools

Free

MIT license, forever

  • Every feature, no exceptions
  • ./build-app.sh and you're running
  • Audit the ~1500 lines yourself
View on GitHub
Skip the toolchain

App

Signed, notarized, ready in 10 seconds

€4.99 one-time

pay more if it saves you a blown run — it will

  • Notarized build, no Gatekeeper warnings
  • All 1.x updates included
  • Keeps the project alive
Notify me when it ships · €4.99

A signed, notarized build is on the way. Join the waitlist and you'll get it the day it ships; the source builds today.
Impatient and comfortable with right-click → Open? Grab the unsigned build (free while in beta).

FAQ

Fair questions

How does Headroom read my usage?

It calls the official usage endpoints (OpenAI's for Codex, Anthropic's OAuth usage API for Claude Code) with the login your CLI already keeps on this Mac. That is the same data codex and claude /status show you, fetched in about 300 ms.

Does anything leave my Mac?

Only the HTTPS requests to OpenAI and Anthropic that your CLIs already make. There is no Headroom server, no analytics, and no account.

Why does macOS ask for keychain access on first launch?

Claude Code stores its login in the macOS keychain. Headroom asks once for read access; click "Always Allow" and you will not be asked again. You can deny it and Headroom will simply show Claude as unavailable.

Is it really open source?

Yes, MIT-licensed on GitHub. The paid build is the exact same code, compiled, signed and notarized so macOS opens it without warnings. If you have the Swift toolchain, ./build-app.sh gives you an identical app for free.

Which tools are supported?

Codex (ChatGPT plans) and Claude Code today. The provider layer is deliberately small; Gemini CLI and Cursor are on the roadmap.

Is this affiliated with OpenAI or Anthropic?

No. Headroom is an independent utility. Codex, ChatGPT, Claude and Claude Code are trademarks of their respective owners.