headroom is by headroomlabs-ai — not by us.
We indexed this project so people can find it. We are not selling it, we host no copy of the code, and we are not affiliated with or endorsed by its authors — get it from them.
Indexed Sep 21, 2026 · 73,355 stars at index time. Maintainers: claiming verifies your identity and unlocks a higher assurance tier. Removal requests are honored.
MCP server · for humans & their agents
headroom
unclaimed listingactively maintainedFreeApache-2.0
Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95%
by Open Source Community · New publisher
Every claim on this page is refundable if it is untrue — refund policy.
headroomlabs-ai/headroom is an open-source project by headroomlabs-ai: 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.. Indexed here so it can be found — not resold.
It is free. Get it from the upstream repository: https://github.com/headroomlabs-ai/headroom
From the project's own README (excerpt, reproduced for discovery under its Apache-2.0 license):
Quickstart · Install · Proof · Agents · Docs · Discord · llms.txt
AI agents / LLMs: read /llms.txt here, or fetch the live index · full docs blob .
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.
10,144 → 1,260 tokens. The same FATAL found.
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 zcode in one command; undo with headroom unwrap . • MCP server — headroomcompress, headroomretrieve, headroomstats for any MCP client. • Cross-agent memory — one shared store across Claude, Codex, Gemini and Grok, with automatic dedup. • headroom learn — mines failed sessions and writes corrections to CLAUDE.local.md (default, gitignored), CLAUDE.md, AGENTS.md, GEMINI.md or GROK.md. • Output token reduction — trims what the model writes back, not only what you send. See below. • Reversible (CCR) — originals are cached locally and retrieved on demand.
How it works • ContentRouter detects the content type and selects a compressor for it. • SmartCrusher / CodeCompressor / Kompress-v2-base handle JSON, source code and prose respectively. • CacheAligner flags volatile content that would bust a provider KV-cache prefix. It never rewrites prompts. • CCR stores originals locally so the model can call headroomretrieve when it needs the full text.
→ Architecture · CCR · Kompress-v2-base model card
Get…
Preview
See what it does before you commit. Previews show behavior, never source code.
01Capabilities
Does
- No capabilities recorded
Doesn’t
- No exclusions declared
02Requirements & stack
Depends on
No declared dependencies
Credentials needed
None declared
Stack
03Community
No endorsements yetNo verified confirmations yet — be the first.
Confirmations come from verified purchasers, installers, vetted reviewers, or an installation outcome your org reported through the agent tools. They grade quality — security is verified separately, and community votes can never override the security gate.
Sign in to confirm — weight comes from verified usage, not vote count.
Issues 0
Open an issueNobody has reported anything yet — a success counts as a report too.
04Trust Passport
Full passport →0/0 automated components pass. An automated score is never a security guarantee.
This listing is unclaimed, so publisher identity cannot be verified and it stays below the “verified” tier by design — that is a statement about the listing, not about the project’s quality. Our automated scans still ran; a maintainer who claims it unlocks identity verification.
05Versions
Full history →| Version | Channel | Released | Notes |
|---|---|---|---|
| 0.0.0 | stable | Sep 21, 2026 | Indexed listing — see the upstream repository for real release history. |