Headroom · Claude usage meter · v1.0
How much Claude
is left?
Headroom puts your Claude plan usage in the menu bar: the 5-hour session limit and the weekly limit, with reset times in the menu. It's about 270 KB, free and open source.
macOS 13+ · needs Claude Code logged in with a Claude subscription
What it does
Session and week
The first number is your 5-hour session, the second is your week. The menu shows when each one resets.
Raycast too
An optional Raycast script command shows the same numbers inline in Raycast.
Private
It reads the login Claude Code already keeps in your Keychain (read-only) and talks only to api.anthropic.com over HTTPS. There's no analytics and no disk cache.
Install
Download the DMG from Releases, or build it from source:
git clone https://github.com/CaptainDiego/headroom && cd headroom
./build.sh installHeadroom uses the same undocumented usage endpoint as Claude Code's /usage, so it may break without notice. It isn't affiliated with Anthropic.
Questions
How can I see my Claude usage limits on Mac?
Headroom is a free, open-source menu bar app that shows your Claude plan usage as two percentages: the 5-hour session limit and the weekly limit, with reset times in its menu. It's the same data as Claude Code's /usage command.
What does Headroom need?
macOS 13 or later and Claude Code logged in with a Claude subscription. Headroom reads Claude Code's existing login from the Keychain, read-only, and talks only to api.anthropic.com. It isn't affiliated with Anthropic.