headroomlabs-ai/headroom
★ 76,135 stars
Covered in week 2026-W28 · the 2026-07 report
Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 60-95% fewer tokens, same answers. Library, proxy, MCP server.
What headroom is
Headroom compresses everything your AI agent reads — tool outputs, logs, RAG chunks, files, and conversation history — before it reaches the LLM. Same answers, fraction of the tokens. Compression runs on your machine; no prompt or file content is sent anywhere to be compressed.
From the repository README · read it on GitHub →
Transcript
Feeding logs, RAG chunks, or tool outputs into Claude or Cursor means burning tokens on raw data your model doesn't need. Headroom compresses all of it before the LLM sees a single byte—same answers, 60 to 95 percent fewer tokens. One proxy wraps your entire stack. On a 17,000-token code search it cuts 92 percent of the waste. 57,000 stars. Would you let your model read uncompressed logs?