Headroom

Privacy policy

Your data stays on your Mac.

Headroom collects nothing. This policy explains what the app reads, what it writes, and what this website logs.

Effective September 25, 2026

The short version

  • Headroom collects no data. No analytics, no tracking, no account and no sign-in.
  • The app makes no network requests. Everything it shows comes from files that Claude Code and the Claude desktop app already write on your Mac.
  • Nothing leaves your Mac. There is nothing for us to see, share or sell.

What the app reads

The Mac App Store version of Headroom runs in Apple’s app sandbox, so it can only read folders you choose. It asks for two, once, in a standard macOS folder picker, and only for folders that exist on your Mac:

  • ~/.claude, Claude Code’s folder. Headroom reads the session files in ~/.claude/sessions to see which sessions are running, their names, project folders and status. From the end of each session’s transcript in ~/.claude/projects it reads the token counts and model name, to show how full the context is. It doesn’t keep or show the text of your conversations. It asks for read and write access to this folder only for the optional Connect terminal feature, below.
  • ~/Library/Application Support/Claude, read only. Headroom reads plan-usage-history.json, where the Claude desktop app records your 5-hour and weekly plan usage.

Headroom reads these files on your Mac while it runs, to draw the pill and the panel. It doesn’t copy them anywhere and keeps no history of them.

What the app stores

Only its own settings, such as launch at login and whether moments show, and the folder permissions you granted. macOS keeps them in the app’s own container, ~/Library/Containers/com.niomartinez.headroom. Deleting the app can leave that folder behind; if it’s still there, you can delete it too.

Connect terminal (optional)

Claude Code in the terminal doesn’t write its plan limits to a file on its own. If you click Connect terminal and confirm the dialog that lists every change, Headroom:

  • backs up ~/.claude/settings.json to ~/.claude/settings.json.headroom-backup first;
  • adds a status line and hooks to ~/.claude/settings.json, keeping your own status line working and every other setting as it was;
  • writes a small script, ~/.claude/headroom/bridge.sh, that Claude Code runs.

The script writes small status files to ~/.claude/headroom on your Mac, for Headroom to read: session ids, folder paths, event names, and context and limit numbers. It never saves your prompts. Disconnect terminal removes exactly what was added, restores your original status line and deletes ~/.claude/headroom.

Disconnect before you delete Headroom. If you don’t, the script keeps writing those files until both the app and its container are gone. Support explains how to clean up.

Network and third parties

The app doesn’t connect to the internet, and it contains no analytics, advertising or crash reporting code from anyone. If you share analytics with app developers in macOS (System Settings, Privacy & Security, Analytics & Improvements), Apple may pass on anonymous crash reports. Apple controls that, and you can turn it off there.

This website

headroom.niomartinez.com is a static website hosted on Vercel. It sets no cookies and uses no analytics or tracking scripts. Like any web host, Vercel may log standard request data, such as your IP address, browser, the page you asked for and the time, to deliver the site and keep it secure. See Vercel’s privacy policy.

If you email us, we use your message and address only to reply, and don’t share them.

Children and changes

Headroom isn’t directed at children, and it collects no data from anyone. If this policy changes, the new version will be posted on this page with a new effective date.

Contact

Headroom is made by Nio Martinez. Questions about privacy go to hello@niomartinez.com.