Pick 1 · AI agents / developer tools GitHub rank #7 of 12
headroomlabs-ai/headroom
Python · License: Apache-2.0
What it does. A local compression layer for AI agents: it shrinks tool outputs, logs, files, RAG chunks and chat history before they reach the model, as a Python/TypeScript library, a local proxy, an MCP server or a one-command wrapper around agents such as Claude Code, Codex, Cursor and Aider.
Caveat. Savings figures (for example 60-95% fewer tokens on JSON) are maintainer benchmarks, and the README says short chats, prose and already-dense output see little or no reduction. An anonymous telemetry beacon is on by default (opt out with HEADROOM_TELEMETRY=off or DO_NOT_TRACK=1). Text compression downloads a Hugging Face model, native packages cover only Apple Silicon Macs and Linux (Intel Macs use Docker), some features fall back to simpler methods on x86 CPUs without AVX2, and wrapping changes your agent's configuration. Prompt-injection filtering is reserved for the paid Enterprise tier. Nothing was installed or run.
Attention, not endorsement
- GitHub showed
- “310 stars today” as displayed for GitHub’s daily window; not an audited rolling 24-hour count
- Total stars
- 76,370 at the metadata check
Primary evidence
- https://github.com/headroomlabs-ai/headroom
- https://api.github.com/repos/headroomlabs-ai/headroom
- https://github.com/headroomlabs-ai/headroom/blob/main/README.md
- https://github.com/headroomlabs-ai/headroom/blob/main/LICENSE
- https://github.com/headroomlabs-ai/headroom/releases/tag/v0.41.0
Metadata checked . README read from https://api.github.com/repos/headroomlabs-ai/headroom/readme, checked .