Headroom
Latest release v0.42.0 on 2026-10-26 · Actively maintained · 15 releases in 90 days
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.
| Latest release | v0.42.0 on 2026-10-26 |
|---|---|
| Maintenance | Actively maintained — pushed within the last 14 days, with 3 or more releases in 90 days |
| Stars | 78,222 |
| Releases in 90 days | 15 |
| Last commit | 2026-10-29 |
| Repository | headroomlabs-ai/headroom |
| Licence | Apache-2.0 |
| Open issues | 509 |
Headroom release notes and changelog
v0.42.0 2026-10-26
Fixed
- Batch: preserve live contexts during capacity cleanup (2cbdd22)
- Batch: preserve native Gemini continuation tools (8757458)
- Cache: bound the router's compression cache, keep the rest in SQLite (b196424)
- Cache: keep indented lines intact in OpenAI whitespace normalization (2480100)
Changed
- Bump base64 from 0.22.1 to 0.23.1 (8d468d4)
- Bump ruff from 0.16.8 to 0.17.0 in the pip-minor-patch group across 1 directory (de3f639)
- Bump the cargo-minor-patch group across 1 directory with 12 updates (683c9a6)
- Bump the npm-minor-patch group across 2 directories with 16 updates (07c8bbf)
v0.41.0 2026-10-14
Fixed
- Anthropic: route /api/hello connectivity probes to Anthropic (931e5b9)
- Beacon: stop Cloudflare logging senders' IP addresses (db983ba)
- Cache: keep cache mode when Claude Code re-serializes its last reply (aeb09f8)
- Cache: retain prefix trackers for the provider cache lifetime (9553d42)
Faster
- Proxy: avoid eager dependency imports (59bd482)
v0.40.0 2026-10-06
Fixed
- Anthropic: preserve failed CCR continuations (94bb055)
- Backends/anyllm: map Anthropic toolchoice none to OpenAI none (d722a64)
- Backends/litellm: align streaming usage tokens with the non-streaming path (90a68e0)
- Backends/litellm: keep the upstream 4xx status on sendmessage errors (e0e41cd)
Faster
- Add savings audit output (9a72bc0)
- Compression/code: avoid a UTF-8 copy per code block in byte-to-char mapping (d5e5534)
- Image: OCR and SigLIP each image once, not once per turn (a8561fb)
- Memory: bound traffic-learner persistedids with the dedup window (7e73438)
Changed
- Proxy: read HEADROOMLICENSE and make usage reporting opt-in
- Drop the crewai extra to remove chromadb from the lockfile
- Bump pyjwt 2.13.0 -> 2.15.1 for CVE-2026-102274 (37b9c46)
- Bump source-map-js from 1.2.1 to 1.2.2 in /docs (e06631a)
Other MCP projects we track
- Codebase Memory · v0.12.1
- Playwright MCP · v0.0.83
- GitHub MCP · v2.0.3
- FastMCP · v4.2.0a1
- Activepieces · 0.87.3-hotfix.1
- MCP Toolbox · v1.15.0
Maintenance status is derived from public repository activity — release cadence and commit recency. It is not a review, an endorsement, or a security assessment. Star counts measure attention, not quality.