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

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
| Repo | Stars | Last commit | Licence | Downloads for |
|---|---|---|---|---|
| biao994 / DocPaws | 176 | 7 days ago | MIT | No downloads |
| trvon / yams | 372 | yesterday | GPL-3.0 | Mac, Windows, Linux |
More: download files, languages, topics and project record
Download files, v0.43.1
- Mac2 files, 63 downloads
- Linux2 files, 95 downloads
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
