Headroom AI — AI skill for Claude Code

Headroom AI

A macOS menu bar app that shows how much of your rate limit is left across many Claude Code and Codex accounts at once: the five-hour window, the weekly one, per-model limits, and when each resets.

It exists because both CLIs only ever show the account you happen to be logged into. With a dozen subscriptions, finding a usable one means switching accounts and checking, over and over.


What it shows

Each account gets a cell with one line per limit window the provider reports. Each line carries its label, how much is used, and when it comes back. Colour appears only when something needs attention, amber past 80% and red at 100%, so a quiet row is a healthy row.

The menu bar carries one indicator per provider. What the number means is yours to choose in Settings:

Setting	Answers
Best account	How full the emptiest account is, so where you would switch to
Busiest account	How full the fullest one is, so what is about to run out
Accounts with room	How many are still under 80%

Whichever you pick, the icon fills the same way. Full means nothing left.

Requirements

macOS 14 or later and a Swift 6 toolchain. No third-party dependencies.

Build and run

make app
open ".build/Headroom AI.app"

swift test

Adding accounts

Click the menu bar icon, then **Add account**, and pick a provider. Your browser opens; sign in there. There is nothing to type, because the account is identified and labelled by the email address its provider reports.

Signing in here creates its own token pair. It does **not** touch the accounts you are logged into in the `claude` or `codex` CLI, and those logins do not touch this app's.

Adding a **Codex** account needs port 1455 free, because that is the only redirect address OpenAI accepts for this flow. It cannot run while `codex login` is waiting.