Skip to content
latestai.eulatestai.eu

Open-source library, proxy and MCP server that compresses tool outputs, logs, RAG chunks and history before they reach an LLM.

Updated EU status checked Last shown

Headroom at a glance

What is Headroom?
Headroom is a library. Open-source library, proxy and MCP server that compresses tool outputs, logs, RAG chunks and history before they reach an LLM.
Does Headroom work in the EU?
Available in the EU. Apache-2.0 library installable via pip/npm and run locally, with no geographic restriction; the README states compression runs on your machine and an offline mode exists (HEADROOM_OFFLINE=1). Telemetry is reportedly on by default, which EU users may want to review. Last verified 14 Nov 2026.
How much does Headroom cost?
Open source, open source. Free under Apache-2.0. A "Headroom for Teams" offering is mentioned in the README; its pricing was not provided. Licence: Apache-2.0.
Where was Headroom shown?
In 1 creator video by Matthew Berman. Most recently by Matthew Berman on 12 Jun 2026, at 11:21 in “You NEED to try these open-source AI projects RIGHT NOW”.

Sources: the vendor's own pages (linked above) and creator videos at the linked timestamps. EU status is information, not legal advice; see how we check.

About

Headroom (headroom-ai on PyPI and npm) is an Apache-2.0 context-compression layer for LLM applications and coding agents. It compresses tool outputs, logs, files, RAG chunks and conversation history before they are sent to the model, with the aim of returning the same answers using fewer input tokens. Compression runs locally, and originals are cached so the model can retrieve them on demand (CCR).

A content router selects a compressor by content type: SmartCrusher for JSON, CodeCompressor (AST-based) for source code, and Kompress-v2-base for text. The README reports 21–57% fewer input tokens across four agent scenarios, 90%+ on repeated JSON arrays and log lines, and little on prose. It also includes cross-agent memory, output-token reduction, and headroom learn, which mines failed sessions and writes corrections to files such as CLAUDE.local.md, CLAUDE.md or AGENTS.md.

It can be used inline (compress(messages, model=...) in Python or TypeScript), as a proxy (headroom proxy --port 8787), as an MCP server, or by wrapping coding agents such as Claude Code, Codex, Cursor, Copilot, Aider and OpenCode with headroom wrap. A YouTube reviewer noted that it installs Serena by default and that telemetry is on by default. Savings depend heavily on content type.

Key features
  • Compresses tool outputs, logs, files, RAG chunks and history before they reach the LLM
  • Three modes: in-process library (Python/TypeScript), local proxy, MCP server
  • One-command wrapping of coding agents (Claude Code, Codex, Cursor, Copilot, Aider and others)
  • Reversible compression: originals cached locally and retrievable via headroom_retrieve
  • `headroom learn` writes corrections from failed sessions to CLAUDE.md / AGENTS.md
  • Built-in `headroom perf` and dashboard for measuring token savings
1 moment

As seen on YouTube

Watch the moment: the exact second top creators show it. Videos load only when you press play, via youtube-nocookie.com.

MA
Matthew Berman12 Jun 2026
Live demo
You NEED to try these open-source AI projects RIGHT NOW

An open-source tool that compresses tool outputs, logs, RAG chunks and history before they reach the LLM, claiming 47-92% token savings with preserved accuracy. Works with Claude Code, Cursor and Codex; includes a perf command and 'headroom learn' to write corrections to Claude.md/agents.md. Caveats: installs Serena by default and telemetry is on by default.

Keep exploring

Similar AI tools

Closest neighbours by meaning, not just by category.