8000 GitHub - aisk/headroom-macos: macOS menu bar app that shows how much quota is left in your AI coding CLIs (Antigravity, Claude Code, Codex, Grok) · GitHub
[go: up one dir, main page]

Skip to content

About

macOS menu bar app that shows how much quota is left in your AI coding CLIs (Antigravity, Claude Code, Codex, Grok)

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

Repository files navigation

Headroom for macOS

A menu bar app that shows how much quota is left in Antigravity (agy), Claude Code, Codex, and Grok. A native Swift port of Headroom for Windows.

Headroom never talks to vendor servers itself and never reads your credentials. It asks the CLIs you already have signed in for their usage, using commands that send no prompts and spend no tokens:

Tool What Headroom runs
Antigravity agy -p /usage --output-format json
Claude Code claude auth status --json, then claude /usage
Codex codex app-server (account/rateLimits/read)
Grok grok agent stdio (_x.ai/billing)

Old CLI versions that might treat /usage as a prompt are skipped, and signed-out CLIs are not polled repeatedly.

Install

Requires macOS 13 or later. Download Headroom-<version>.dmg from Releases (universal: Apple silicon and Intel) and drag Headroom into Applications.

The app is not notarized by Apple, so macOS refuses to open it at first ("Headroom is damaged" or "cannot be verified"). Remove the download quarantine flag once:

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

Alternatively, try to open it, then choose Open Anyway in System Settings › Privacy & Security.

Usage

Click the menu bar icon to see your usage; right-click it for Refresh, Settings and Quit. The icon shows one bar per tool, which turns red below 10%.

Settings: launch at login, which tools to show, refresh interval, and whether to show your account email in full, partially hidden, or not at all.

Build

Requires Xcode 16.

swift test
make app    # build/Headroom.app
make dmg    # build/Headroom-<version>.dmg (universal)

License

GPL-3.0. Not affiliated with Google, Anthropic, OpenAI, or xAI.

About

macOS menu bar app that shows how much quota is left in your AI coding CLIs (Antigravity, Claude Code, Codex, Grok)

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0