Skip to content

Release notes

What’s new in each version of Headroom for Mac. The app updates itself, or you can download the latest from the homepage.

Headroom 1.5 · Latest

Your menu bar, your widgets, and reminders before usage resets

  • Arrange the menu bar. Add, remove and reorder provider pills in Settings › Menu Bar, and choose which limit each pill follows: 5-hour, weekly, a model limit, either Cursor pool, or Closest to limit.
  • Use it before it resets. Optional notifications tell you when a limit is about to reset with usage still left. Codex can also tell you when a new banked reset arrives. Both are off until you turn them on in Settings › Notifications.
  • Pick a widget style. Each Mac widget can be Nested Meter, Vessel Hero, Tightest First or Liquid Level, Always colored or Only when low. Choose in Edit Widget.
  • More accounts, smarter refreshes. Up to 20 accounts per provider for Claude, Codex and Grok. Each account refreshes on its own schedule, and a manual refresh shows each account’s result as it lands.
  • More detail. Codex shows banked resets on its plan badge. Cursor shows its Cursor Models and Other Models pools separately.
  • Clearer and faster. Loading, waiting and fresh readings each look different. An account that needs attention shows one clear action. The popover opens instantly at full height.
  • About and updates. A new About pane, and an option to download and install updates automatically.

Headroom 1.4.1 ·

Popover buttons stay right-side up

  • Fixes an issue where Refresh and Quit could appear upside down after switching display styles.

Headroom 1.4.0 ·

Settings, reorganized — and meters you can tune

  • Settings, reorganized. Six sections in a sidebar, with live previews of the popover, menu bar, and widgets that update as you change a setting.
  • Choose how meters look. Pick a format, shape, and fill in Appearance. Only when low keeps meters neutral until usage runs low.
  • Color account titles by provider. An optional display setting tints each account title with its provider’s brand color.
  • Readable on light wallpapers. The menu bar label follows the menu bar’s own appearance, so it stays legible over bright desktops.
  • A calmer popover. Cleaner account rows, sharper meters, subtle motion when values change, and a clearer edge when the list scrolls.