Skip to content

Headroom Mobile 0.4.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@Athuli7 Athuli7 released this 30 Oct 19:35
· 17 commits to main since this release
mobile-v0.4.0
29005b5
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

The first preview of Headroom on iPhone, iPad and Apple Watch, fed by your Macs over iCloud.

  • Headroom for iPhone, iPad and Apple Watch. A new mobile app shows Now, account details, Activity and your Macs, with demo data to try it before syncing. It includes Home Screen widgets (including Accounts and Activity), Lock Screen and watch-face complications, a Live Activity for your 5-hour session, and a watchOS app.

  • iCloud sync from your Mac. A new Settings section on the Mac, off by default, publishes your readings to iCloud. Data from every Mac you sync is merged into one view per provider account, and payloads are encrypted. Nothing leaves your Apple Account.

  • See at a glance whether your week will last. Each provider gets a meter in the menu bar. The popover gives a plain verdict on whether you have room to spare, are on pace, or should slow down. It also shows a projection of where the week is heading and a history of past weeks.

  • Warnings when recent use will run you out early. If you've been spending fast over the last couple of hours, Headroom warns you that you'll run out before the reset. Your daily pace stays available as extra context.

  • First-class 5-hour sessions. Each session gets a forecast: how long it will last, how much you'll have spare at reset, or when it runs out. A meter and graph cover the running session from start to reset, and a 24-hour trail of recent sessions shows between them.

  • Desktop widgets on the Mac. Three widgets are available:

    • Burn-o-meter: a speedometer of how fast you're spending, with a safe speed marked.
    • Headroom: what's left this week.
    • 5-Hour Session: a countdown ring for the current session.

    All three use the same forecast wording as the popover.

  • Activity and cost breakdowns. See your token use by model, project and token class, with estimated costs. Models without a known price are flagged in a footnote rather than guessed.

  • Welcome window and redesigned Settings. A short setup guide runs on first launch to pick providers and shape the menu bar. Settings now has sidebar sections with a live preview. You can configure:

    • The 5-hour warning level.
    • The menu bar percentage and an always-on session timer.
    • Appearance.
    • Notifications for nearing or hitting a limit, a session coming back, a tight week, and credits lapsing.

  • Privacy-safe sharing. Copy a card image, a snapshot or text of your status. Shared content never includes project names, paths or session IDs.

  • headroom in the terminal. Get a summary, JSON output, a status line for Claude, tmux, SketchyBar or plain text, and a wait command.

  • Keep Awake. Keep your Mac from sleeping from the right-click menu. Choose a set time from 15 minutes to 8 hours, run indefinitely, or stay awake until your next session reset.

  • Fan Control. Set a two-point fan curve from the right-click menu, with a choice of temperature sensor. Temperature and fan speed can be shown in the menu bar. Fan Control needs a helper approved in Login Items.

  • Automatic updates. Headroom checks for updates daily and updates itself. A blue dot appears on the menu bar icon when an update is waiting.

  • Easier to install. Headroom comes as a signed, notarized DMG and through Homebrew as ai-headroom, and it runs on macOS 15 Sequoia and later.

  • Light on your Mac. The app idles at about 16–17 MB of memory and reads your usage logs locally. It only contacts Anthropic's usage API and the Claude and OpenAI status pages.

Install this pre-release:

curl -fsSL https://raw.githubusercontent.com/ScaleXY/headroom/main/install.sh | bash -s -- --version mobile-v0.4.0

Full changelog: https://github.com/ScaleXY/headroom/commits/mobile-v0.4.0

Assets 2
Loading