OpenDMG
Headroom icon

Headroom for Mac

Quota island beside the screen notch showing how much usage you have left on Claude, Codex, Grok, and Cursor — tiny dots at a glance, draining rings on hover, and full quota windows, reset countdowns, and local spend when you click.

By PeytonNowlin. Free and open source, MIT licence.

Get it with OpenDMG View source on GitHub

Headroom at a glance

Version
0.6.0
Released
22 September 2026
Download size
2.2 MB
Works on
Apple silicon and Intel
Licence
MIT
Category
Artificial Intelligence
Developer
PeytonNowlin
GitHub stars
3

About Headroom

Free, open-source AI quota tracker for macOS: tiny LED gauges beside the notch for Claude, Codex, Grok, and Cursor.

How to install Headroom on a Mac

  1. Get OpenDMG. It is a free app store for open source Mac apps. Download OpenDMG.
  2. Search for Headroom and press Get. OpenDMG downloads version 0.6.0 from PeytonNowlin's own GitHub release.
  3. Open it. The download is checked against its SHA-256 fingerprint and its signature is checked on your Mac before it lands in Applications.

Updates to Headroom show up in OpenDMG and install with one button. No account is needed.

Prefer to do it by hand? The developer's file is on GitHub: Headroom-0.6.0.dmg (2.2 MB).

What is new in Headroom 0.6.0

### Added

- Provider tiers. Each provider is **Main**, **Side**, or **Hidden** — one control that replaces the old visibility picker and the per-provider alert switches. Claude and Codex default to Main; Grok, Cursor, and OpenCode default to Side. Main agents are the ones whose quota stops your work, so only they can bring the island on screen.
- A dormant island. While every main agent has room and none is broken, Headroom draws nothing at all: no band, no gauges, no glass. The notch band stays hoverable, so moving the cursor there (or pressing the hotkey) still summons it.
- Compact gauges now carry each provider's glyph, and main gauges are drawn larger than side gauges, so two gauges beside the notch are never ambiguous. Main gauges sit left of the notch, side gauges right of it.
- The band sizes itself to its gauges instead of clipping them, and the expanded island's height is measured from its content instead of being fixed.

### Changed

- Only providers with something to say get a compact gauge: past the first urgency step, or a login that stopped working. Everything else is silence.
- The expanded island separates main agents (full rings, name, and when quota comes back) from side providers (smaller rings and a name).
…

More Artificial Intelligence apps

All Artificial Intelligence apps