Find tools › Open-source projects › Spend less on AI

headroom

Open-source project · by headroomlabs-ai

A tool on your computer that shrinks what your AI helper reads, so each request costs less.

Some setupVery popular448,438 installs a month

What it costs

Free and open source; you may pay for the AI model it uses.

Use it to

  • Compress long logs and tool output before Claude Code reads them
  • Lower token costs on tasks with lots of repetitive data
  • Stretch a usage limit further during agent sessions

How to start

  1. Install the uv Python installer if you do not have it.

  2. In a terminal, run uv tool install --python 3.13 "headroom-ai[all]".

  3. Then start Claude Code through Headroom with its wrap command, as the README shows.

  4. Use its unwrap command later to remove the extra Serena add-on it installs.

Good to know. Savings depend heavily on content: the README's own benchmarks show about 21-57% on realistic agent tasks and 90%+ only on very repetitive JSON/logs, with little gain on prose. 'headroom wrap' also installs the Serena MCP server at user scope, which stays until you run 'headroom unwrap'.

Before you install

  • Checked by a personWe read what it does before listing it.
  • License: Apache-2.0You are allowed to use it under these terms.
  • Last updated 2026-11-17

More detail

Headroom compresses what an AI agent reads (tool outputs, logs, JSON, files, retrieved documents) on your own machine before it is sent to the model, and is available as a Python/TypeScript library, a local proxy, an MCP server, or a one-command wrapper for coding agents.

Long tool outputs fill the context window and cost money; Headroom shrinks them and keeps the originals locally so the model can fetch the full text when it needs it. People use it when agents work with large logs, search results or JSON.

Similar tools

Descriptions are written in plain English from each project's own documentation and refreshed by our agent; this one was last checked 2026-09-29. Spotted a mistake? · Open in Find tools · © 2026 Which AI Map