# headroom

> The Context Optimization Layer for LLM Applications

- **URL**: https://www.freshcrate.ai/projects/headroom
- **Author**: chopratejas
- **Category**: MCP Servers
- **Latest version**: `v0.22.4` (2026-06-01)
- **License**: Apache-2.0
- **Source**: https://github.com/chopratejas/headroom
- **Homepage**: https://chopratejas.github.io/headroom/
- **Language**: Python
- **GitHub**: 1,474 stars, 124 forks
- **Registry**: github
- **Tags**: `agent`, `ai`, `anthropic`, `compression`, `context-engineering`, `context-window`, `fastapi`, `langchain`, `mcp`, `python`

## Description

The Context Optimization Layer for LLM Applications

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.22.4` | 2026-06-01 | High | ## What's Changed * fix(cli): wrap CLI breadth — cline, continue, goose, openhands by @chopratejas in https://github.com/chopratejas/headroom/pull/492 * fix(subscription): wire tokens_saved_rtk data plane by @chopratejas in https://github.com/chopratejas/headroom/pull/493 * fix(observability): RTK metrics + Rust observability (Phase H blocker) by @chopratejas in https://github.com/chopratejas/headroom/pull/494 * ci(release): adopt release-please for gated publishes by @chopratejas in https://git |
| `v0.22.2` | 2026-05-20 | High | ## [0.22.2] - 2026-05-20  ### Bug Fixes - **memory**: expose memory IDs in auto-tail + memory_list tool + ID-usage guidance (f844f64) |
| `v0.21.36` | 2026-05-14 | High | ## [0.21.36] - 2026-05-14  ### Documentation - improve discoverability for AI agents and search crawlers (bcf5517) |
| `v0.21.6` | 2026-05-08 | High | ## [0.21.6] - 2026-05-08  ### Bug Fixes - **ci**: update sdist license-packaging invariant test to match new shape (cd89a82) |
| `v0.20.10` | 2026-05-02 | High | ## [0.20.10] - 2026-05-02  ### Bug Fixes - **proxy**: cache concurrency lock, multi-worker docs, bounded compre… (51eeaf6) |
| `v0.10.17` | 2026-04-26 | High | ## [0.10.17] - 2026-04-26  ### Other Changes - rust stage 3 (a+b): diff_compressor port + retire python via pyo3 + dotenv test hygiene (fcef84f) |
| `v0.9.2` | 2026-04-22 | High | ## [0.9.2] - 2026-04-22  ### CI/CD - publish Python distributions to GitHub releases (5738339)  ### Other Changes - Sync plugins to 0.9.2, pyproject canonical at 0.9.1 [skip ci] (7ed2b0b) |
| `v0.8.3` | 2026-04-21 | High | ## [0.8.3] - 2026-04-21  ### Bug Fixes - **onnx**: reduce retained cpu memory (80920ed) |
| `v0.8.2` | 2026-04-21 | High | ## [0.8.2] - 2026-04-21 |
| `v0.8.1` | 2026-04-21 | High | ## [0.8.1] - 2026-04-21  ### Bug Fixes - **telemetry**: add headroom_stack and install_mode identity fields (b789dca)  ### Documentation - port Docker-native, filesystem-contract, and persistent-installs pages to Fumadocs (724c298) |

## Citation

- HTML: https://www.freshcrate.ai/projects/headroom
- Markdown: https://www.freshcrate.ai/projects/headroom.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/headroom/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._