See what's left, and when it resets.It runs on your own server.
Each linked account gets a panel: its 5-hour session, weekly pools, per-model limits, credits and banked resets.
Every account in one list, sorted by how near it is to running out.
Ranks the accounts of one provider by room left and names the one to use.
Every limit window on a calendar, so you see the next reset before you need it.
Subscriptions, usage spend and top-ups in one currency, with renewals.
A message in the app, on Telegram or by webhook when a limit runs low.
Providers
No cloud version
There is no hosted version, on purpose.A hosted copy would hold everyone's logins.So you run your own.
Install
Free and open source.Pick the way you already use.Each one runs the same app.
Updates, start at login and removalRecommendedFor a Mac or Linux machine.
$ curl -fsSL https://headroom.theblank.club/install
| sh$ headroom --open
You already use Homebrew.
$ brew tap amitray007/headroom
https://github.com/amitray007/headroom$ brew install amitray007/headroom/headroom$ headroom --open
You have Node.js. Nothing else to set up.
$ npx headroomhq --open
You use Python tools like uv.
$ uvx headroomhq --open
You manage your tools with mise.
$ mise use -g github:amitray007/headroom$ headroom --open
For Windows, a home server or a NAS.
$ docker run -d --name headroom \-p 8080:8080 \-v headroom-data:/var/lib/headroom/data \-v headroom-secrets:/etc/headroom \ghcr.io/amitray007/headroom:latest