Headroom

For your AI plan limits

Know your headroom.Before you hit the limit.

A free menu bar app for your Mac. See how much of your Claude, Codex and Copilot plans is left, and what every session is doing. No account, local by default.

Download on the Mac App Store
See how it works

Now on the Mac App Store · Free · macOS 14 or later

The Headroom panel with sample data: weekly limit 89 percent, resets Sunday 7 PM; 5-hour limit 14 percent, resets in 2 hours 50 minutes; two sessions working and five idle, each with a context bar.

A live replica with sample data. Click the pill to close the panel.

Download on the Mac App Store

Now on the Mac App Store · Free · macOS 14 or later

What it shows

Everything you keep checking, one glance away.

Your plan limits, your sessions and their context, right where you already look: the menu bar.

How it works

Three steps, then just glance.

A short setup gets you started. Every connection is optional, and you can add more tools anytime.

  1. 1

    Install

    Get Headroom free from the Mac App Store and open it. It lives in your menu bar, next to the clock.

    Mac App StoreFree
  2. 2

    Choose your tools

    Choose Claude, Codex or Copilot. Setup shows the connections for that tool and asks for the folder access it needs. Add another tool, set up later, or choose Try sample data to look around first.

    ~/.claude~/.claude~/Library/Application Support/Claude~/Library/Application Support/Claude~/.codex~/.codex
  3. 3

    Glance

    That's it. The pill keeps count and the rings keep score. Click it whenever you want the details.

Screenshots

See it up close.

Shown with sample data. Your own sessions and folders never leave your Mac.

A Mac desktop with the Headroom pill in the menu bar and its panel open: weekly and 5-hour limits with reset times, then sessions with context bars. All data is sample data.
Your AI limits, one glance away.
The Headroom panel listing sample sessions grouped as working, needs you and idle, each with a context bar.
Every session, working or waiting.
The pill with an amber ring and number as the weekly limit nears, and a moment announcing the limit.
Know before you hit the limit.
Terminal sessions next to desktop app sessions in the panel, and the Connect terminal setting.
Desktop app and terminal.
Headroom works from files already on your Mac: no account, local by default, and no data collected. Only Copilot usage talks to GitHub, and only if you connect it.
No account. Local by default.
The panel with Claude's limits on top, compact rows for Codex and Copilot, and Claude, Codex and Copilot sessions tagged by tool. Beside it, the pill showing Claude, Codex, or one gauge per tool. All data is sample data.
More tools, one panel.
A desktop with three Headroom widgets: small Limits with Claude's rings, medium Sessions, and large Sessions with every tool's limits and sessions. All data is sample data.
Widgets for your desktop.
Eight menu bar pills: working, a session that needs you, near the limit, critical, faded rings for old data, and moments that read 'Update pricing table finished', 'harbor needs you' and 'Weekly at 90%'.
The pill, in every state. Moments widen it for a few seconds.

New in 1.1

More tools, the same glance.

Codex, Copilot and widgets, with the same privacy rules.

October 10, 2026 · Headroom 1.1 is now available free on the Mac App Store.

Also in 1.1

Click a session to open it, “needs you” stays until you look, a key for the two rings, and you pick the tool the rings show.

  • Click a session to open it
  • “Needs you” stays until you look
  • A key for the two rings
  • Pick the tool the rings show

October 5 · 1.1 refinements · Available

An easier start. Clearer sessions.

Choose a tool in the new setup, connect what you need, or try sample data first. Small, colored session icons stay visible when you track several tools, even when only one currently has sessions.

  • Setup at your pace. Add another tool or finish later. Reopen setup anytime from Settings → General → Set up tools.
  • Copilot completions stay visible. A completed session can close immediately without losing its completion moment. Connect Session activity separately from GitHub usage, then start a new Copilot session.
  • Icons on the rings. When you track more than one tool, each ring shows its tool’s icon, in the menu bar and in the panel, so you can tell them apart at a glance.
  • Company Copilot seats. If your organization pays for a Business or Enterprise seat, Headroom shows its monthly AI credits as a percent.
  • A number for every warning. With one gauge per tool, Claude, Codex and Copilot each show their own percentage from 75% usage.
  • A fit for your menu bar. Automatic expands titles when there’s room and keeps your selected gauges. Always compact keeps one gauge and full titles in the panel.
  • Background work counts. A Claude session stays under Working while a background command or agent is still running, even between replies.
  • Codex fades only when it might be behind. With no Codex session running, an older Codex reading shows its age without fading.
  • Running tasks stay counted. Reopening Headroom picks up Codex tasks already in progress, including long sessions.
  • Calmer transitions. Titles, rings and numbers move together. Transitions finish even if the display stops sending frames, so updated notices can appear. A drawn check marks completion; a quiet row outline appears when you navigate by keyboard.
Headroom with sample sessions: the Claude icon in its ring, a colored tool icon between each status dot and task title, and one small Claude, Codex and Copilot legend below the list.

October 18 · 1.1.1 · Available

Refresh on demand. Review what finished.

Pull fresh numbers when you want them, and look over finished work before it drops into Idle.

  • Refresh now. A button next to Settings reads your limits and sessions again right away and fetches Copilot usage. Claude and Codex numbers are as new as their apps last recorded them.
  • Just finished. A session that finishes gets its own section above Idle. It stays there until you open it from Headroom, dismiss it, clear the section, or continue the session.
  • Cleared once you’ve seen it. Opening the session in the Claude or Codex app, or bringing its terminal or the Copilot app forward, moves it to Idle too, the way Needs you clears when you answer in the app. 1.1.2 · Available
Headroom with sample sessions: a Just finished section with two sessions and a Clear button between Working and Idle, and a Refresh button beside the gear in the footer.

FAQ

Questions, answered.

More on the support page.

Where do I get Headroom?

Download Headroom free from the Mac App Store using the download button on the Headroom home page. It runs on macOS 14 Sonoma or later.

Is Headroom made by Anthropic, OpenAI or GitHub?

No. Headroom is an independent app made by Nio Martinez. It isn't made by, affiliated with or endorsed by Anthropic, OpenAI or GitHub.

Does it need my Claude login?

No. There is no Headroom account, and it never asks for your Claude login. Headroom reads files that Claude Code and the Claude desktop app already write on your Mac.

Does Headroom read my Codex login?

No. It reads Codex's session files and never opens its sign-in file.

Why does Copilot need a sign-in?

Copilot's usage is kept on GitHub, not on your Mac. Headroom uses its own read-only GitHub sign-in, only if you turn it on.

Can I see my company's Copilot seat?

Yes. If an organization pays for your Business or Enterprise seat, nothing is billed to you, so Headroom asks GitHub for that seat's monthly AI credits instead, with the same read-only sign-in, and shows them as a percent.

Does it send my data anywhere?

No. Headroom has no analytics, collects nothing and sends nothing to its developer. Claude and Codex work entirely from files on your Mac.

The one exception is opt-in: if you connect GitHub, Headroom asks GitHub for this month's Copilot usage, and talks to nothing else.

Which plans does it work with?

Claude: the 5-hour and weekly limits show for Pro and Max plans, and they cover chat, Cowork and Claude Code alike. Sessions and context bars show for anyone using Claude Code. If you use Claude Code in the terminal, click Connect terminal once, so Headroom can see those sessions and their limits too.

Codex: the weekly limit, as Codex records it while you use it. With an API key there are no limits to show.

Copilot: this month's usage. On a plan you pay for yourself, pick it in Settings to see a percent; a Business or Enterprise seat shows its monthly credits as a percent on its own.

How do I add the widgets?

Control-click the desktop and choose Edit Widgets, then search for Headroom. Limits shows the rings; Sessions shows what's running. Both come in Notification Center too.

Which Macs does it run on?

Any Mac with macOS 14 Sonoma or later.

Is it free?

Yes. Headroom is free, with no ads and no account.

Know your headroom.

Free on the Mac App Store. Questions or ideas? Write to hello@niomartinez.com.

Download on the Mac App Store