Skip to content

v0.1.0 — first public release

Choose a tag to compare

View all tags
@domanski-ai domanski-ai released this 12 Jul 13:15
v0.1.0
b53759a

headroom tracks the remaining capacity of every Claude and ChatGPT/Codex subscription you own — read live, without spending a single token — puts it on a dashboard you'll actually want to look at, and rotates your tools to the next account with headroom the moment one hits a limit.

Highlights

  • Live usage, both providers. Claude via the OAuth usage API; Codex via the Codex app-server (account/rateLimits/read). Real-time and identity-bound — never a stale guess.
  • A dashboard worth looking at. Five switchable themes (Midnight, Minimal, Chrome, Paper, Terminal) with an instrument bar of meters, gauges and per-account bars. Try it before connecting anything: headroom serve --demo.
  • Fail-closed rotation. headroom claude / headroom codex launch on an account with proven headroom; on a limit-hit, headroom rotate cools it down until its window resets and hands you the next one.
  • Claude Code integration. A color-coded status line and a /rotator skill.
  • Safe by construction. stdlib-only Python (3.9+), no network beyond the two read endpoints, emails redacted by default, credentials never moved. Adversarially reviewed cross-model before release.

Quickstart

git clone https://github.com/domanski-ai/headroom
cd headroom
./install.sh
headroom serve --demo   # preview with sample data, no setup
headroom setup          # connect your accounts

See the README for the full command list and docs/HOW-IT-WORKS.md for the architecture. MIT licensed.

Assets 2
Loading