Headroom
- Open source
- AI agents
- npm and Homebrew
a fuel gauge for AI agents
For your organisation: a team that runs AI agents on subscriptions sees up front whether a job still fits, and does not stall halfway through.
Keeps an AI agent from stalling halfway through a job because the plan ran out. Headroom reads how much room is left in your Claude and Codex plans and tells the agent: start, wait or switch to another plan. Open source.
Tech stack: TypeScript; a command-line tool, a connector for AI assistants (MCP) and a Claude Code plugin. Installs with npm or Homebrew.
9,605 downloads in two months
More about HeadroomClose
What it does
Go, wait or switch
Headroom reads the 5-hour and weekly limits of your Claude and Codex plans and gives an agent one answer: start, wait, or switch to a plan with room. Open source (MIT), installs with npm or Homebrew, as a command-line tool, as an MCP server (the connector AI assistants use to call a tool) and as a Claude Code plugin.
- since the first release on 5 September 2026, up to 5 November
- 9,605 npm downloads
- in the 30 days up to 5 November 2026
- 3,578 npm downloads
Download figures from npm for the package, 5 September to 5 November 2026, read on 6 November.
npm downloads per week
- 4 Sept
- 2,067
- 11 Sept
- 966
- 18 Sept
- 882
- 25 Sept
- 1,194
- 2 Oct
- 1,012
- 9 Oct
- 174
- 16 Oct
- 1,283
- 23 Oct
- 674
- 30 Oct
- 1,353
Per week, for the npm package headroomd, 4 September to 5 November 2026. npm counts every install, automated ones too. Homebrew installs go through npm and are included in this number. npm downloads, running total
- 4 Sept
- 2,067
- 11 Sept
- 3,033
- 18 Sept
- 3,915
- 25 Sept
- 5,109
- 2 Oct
- 6,121
- 9 Oct
- 6,295
- 16 Oct
- 7,578
- 23 Oct
- 8,252
- 30 Oct
- 9,605
The same, added up from 5 September: 9,605 on 5 November.