Repository navigation
Headroom 0.3.0
This release adds desktop widgets, so you can keep an eye on your limits without opening the menu bar.
-
New desktop widgets. Right-click your desktop, choose Edit Widgets and search for Headroom. There are three:
- Burn-o-meter (small, medium and large) is a speedometer for how fast you're spending your 5-hour session and your week, in percent per hour. The needle reads against the pace that lasts until the reset, and the widget shows how fast you can safely go. The large size adds your tokens and the API-rate cost for the last 24 hours.
- Headroom (small, medium and large) shows what's left this week, where it's heading and when it renews. With two accounts signed in, the medium size shows both.
- 5-Hour Session (small and medium) counts down to the reset, with a ring that shows what's left and a graph of the last day of sessions.
Every widget gives the same forecast in the same words, like "70% left at the reset" or "Runs out 14:20". Click any widget to open Headroom.
-
The session graph keeps the last 24 hours. In the popover, each 5-hour session dips as you use it and steps back up at its reset, so you can see how your day went.
-
Earlier run-out warnings. When a heavy stretch of work would use up your week before it renews, Headroom now warns you from your recent usage instead of waiting for the daily average to catch up.
-
An update dot in the menu bar. When an update is ready, a small blue dot appears on Headroom's icon, and the right-click menu offers to update and restart.
-
Fan Control takes over more reliably. If macOS is slow to hand over the fans, Headroom now retries for a few seconds instead of failing.
Install or update:
curl -fsSL https://raw.githubusercontent.com/ScaleXY/headroom/main/install.sh | bash
Or with Homebrew: brew upgrade --cask ai-headroom.
Full changelog: v0.2.0...v0.3.0