How it works
Each request a coding agent makes carries far more than your prompt: file contents, command output, search results, and the whole conversation so far. Most of that is machine-generated and repetitive. Headroom compresses it locally, keeps the originals on your machine, and forwards the smaller request to your provider. When the model needs the full text of something it compressed, a retrieval tool fetches it back.
Savings depend on the work. Debugging from logs, shell-heavy tasks, and large JSON or HTML inputs compress well; short prompts barely change. The reviews quote what users saw on their own work. Fewer tokens per task also means less inference energy; see how Headroom makes AI coding more sustainable.
Subscriptions and the API
On a Claude Pro or Max plan, or a ChatGPT plan with Codex, you do not pay per token, so the savings show up as rate-limit headroom: the 5-hour and weekly windows last longer. It does not change your plan's price or the limits your provider sets. On the API, fewer input tokens is a smaller bill. The dashboard's dollar figures are API-equivalent costs; how savings are measured defines them and separates measured input compression from estimated output reduction.
Add-ons and project learnings
Eight optional add-ons each target another source of tokens: RTK (terminal output), MarkItDown (documents), Serena and Codebase Memory (code navigation), Context7 (library documentation), and Ponytail, Caveman and Chisle (shorter code and replies). Project learnings write reusable commands and environment details into the agent's instruction files so it stops rediscovering them. The tutorials show both in common tasks.
Privacy
Compression runs on your machine. Your requests still go to Anthropic or OpenAI as before; Headroom does not need your prompts or source code on its servers. The privacy policy covers accounts and telemetry.
Headroom AI: the app and the open-source CLI
The compression engine is the Headroom CLI, an open-source (Apache 2.0) project created by Tejas Chopra. It installs with pip install headroom-ai, which is why it is often called Headroom AI; the desktop app runs the same engine, so you do not need both. The desktop app is built on it with his endorsement and adds installation, automatic updates, agent connectors, add-ons, and a dashboard. The CLI is free; the app has a 7-day free trial with no credit card, then paid plans. Desktop app vs CLI compares them.
Installing and removing it
The install guide covers both the app and the CLI, and the quickstart shows how to connect an agent and confirm it routes through Headroom. Updates install in the background on macOS; the update guide covers Windows, Linux, and the CLI. Quitting Headroom removes its routing; open a new terminal afterward. For a full cleanup, use Settings > Uninstall Headroom as described in the uninstall guide; deleting the app alone leaves integrations and local data behind. If an agent is doing the setup, point it at the agent runbook.