headroomlabs-ai/headroom

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

About the project

Headroom is a library, proxy, and MCP server that compresses tool outputs, logs, files, retrieval chunks, and conversation history before they reach a language model. It helps coding agents use fewer context tokens while keeping the original content available locally when needed. Its catalogue add-ons support using Headroom with agent workflows.

This repository also configures its own agents. See what headroom tells them →

75kStars on the repository
4Mods indexed here, across every type
todayLast push, which is what freshness is scored on
Apache-2.0Licence, which decides whether bodies are shown

headroom

01

headroomlabs-ai/headroom

Plugin Claude Code

Bundles 2 hooks

Headroom startup hooks for Claude Code and GitHub Copilot CLI.

not rated 75k +612 changed yesterday A tokens not measured original Apache-2.0