Skip to content
The Daily Repo

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.

Why this job: says: rag; topics: rag

Headroom compressing a 10,144 token log dump to 1,260 tokens while preserving the FATAL line

What it does

  • Library. compress(messages) in Python or TypeScript, inline in any app.
  • Proxy. headroom proxy --port 8787, zero code changes, any language.
  • Agent wrap. headroom wrap claude|codex|grok|copilot|cursor|aider|opencode|cline|continue|goose|openhands|openclaw|vibe|omp|droid|zcode in one command; undo with headroom unwrap .
  • MCP server. headroom_compress, headroom_retrieve, headroom_stats for any MCP client.
  • Cross-agent memory. one shared store across Claude, Codex, Gemini and Grok, with automatic dedup.

Get started

pipx install --python python3.13 "headroom-ai[all]"
Maintenance
Active
Last commit yesterday
Stars
79,185
+553 this week
Licence
Apache-2.0
Allows business use
Downloads for
2 systems
Mac, Linux
Latest version
v0.43.1
Released 4 days ago
Built with
Python
81% of the code

Is it looked after?

Contributors
49
Last 90 days
Issues
91% closed
123 still open
Pull requests
2,456 merged
149 waiting
Releases
177
30+ in the last year

Similar repos

Repos similar to this one
RepoStarsLast commitLicenceDownloads for
biao994 / DocPaws1767 days agoMITNo downloads
trvon / yams372yesterdayGPL-3.0Mac, Windows, Linux
More: download files, languages, topics and project record

Download files, v0.43.1

  • Mac2 files, 63 downloads
  • Linux2 files, 95 downloads

All files on GitHub (opens in new tab)

Languages

  • Python 81%
  • Rust 12%
  • JavaScript 3%
  • TypeScript 2%

Topics

  • agent
  • ai
  • anthropic
  • compression
  • context-engineering
  • context-window
  • fastapi
  • langchain
  • llm
  • mcp
  • openai
  • proxy

Project record

  • JobRAG and search
  • StatusFeatured
  • Commits3,639
  • Forks6,194
  • Watching213
  • Stars in 28 days+4,291
  • CreatedJan 7, 2026
  • First seen by usNov 7, 2026
  • CheckedNov 9, 2026

Type to search.

Try