Apertur3/headroom

README preview

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/banner-dark.svg">
    <img alt="headroom: a fuel gauge for AI coding agents" src="docs/assets/banner-light.svg" width="640">
  </picture>
</p>

**Your coding agents check their Claude and Codex limits before they start a job.**

headroomd reads the 5-hour and weekly limits your subscriptions report and answers go, wait or reroute, over the CLI or MCP.

<p align="center">
  <img alt="Terminal demo: Headroom checks Claude and Codex quota, waits or reroutes when needed, and reserves capacity before a job" src="docs/assets/headroom-demo.gif" width="720">
</p>

```sh
npm install -g headroomd   # or: brew install apertur3/tap/headroom
headroom setup
headroom can claude-fable --owner me && echo go
```

View full repository on GitHub →