{"full_name":"headroomlabs-ai/headroom","owner":"headroomlabs-ai","name":"headroom","shard":"1","url":"https://github.com/headroomlabs-ai/headroom","description":"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.","homepage":"https://docs.headroomlabs.ai/docs","topics":["agent","ai","anthropic","compression","context-engineering","context-window","fastapi","langchain","llm","mcp","openai","proxy","python","rag","token-optimization"],"tag_pages":["agent","ai","anthropic","compression","context-engineering","context-window","fastapi","langchain","llm","mcp","openai","proxy","python","rag","token-optimization"],"language":"Python","license":"Apache-2.0","avatar":"https://avatars.githubusercontent.com/u/294291659?v=4","created_at":"2026-01-07T19:58:51Z","pushed_at":"2026-11-15T15:29:28Z","metrics":{"stars":79731,"forks":6243,"watchers":213,"issues":1364,"prs":3372,"releases":178,"issues_open":130,"issues_closed":1234,"prs_open":182,"prs_closed":642,"prs_merged":2548,"discussions":92},"growth":{"day":{"stars":39,"forks":3,"base_day":"2026-11-15"},"week":{"stars":538,"forks":51,"base_day":"2026-11-09"}},"history":{"dates":["2026-11-09","2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[79193,79281,79354,79439,79473,79615,79692,79731],"forks":[6192,6198,6208,6214,6219,6230,6240,6243],"watchers":[212,212,212,213,213,213,212,213],"issues_open":[null,null,127,131,131,128,130,130],"prs_open":[null,null,148,161,168,172,181,182]},"boards":{},"same_owner":[],"issues":[{"number":4613,"title":"[BUG] Proxy leaks compression-executor threads (image OCR?), pinning cores.","comments":6,"created_at":"2026-11-02T09:50:57Z"},{"number":4433,"title":"[BUG] security-model.mdx says an unsafe x-headroom-base-url override is \"ignored\", but the proxy routes answer 400","comments":6,"created_at":"2026-10-22T17:32:47Z"},{"number":3563,"title":"[BUG] CCR recovery JSON re-offloaded through Codex functions.exec wrapper; named retrieval exemption passes","comments":6,"created_at":"2026-09-12T00:44:31Z"},{"number":3187,"title":"[FEATURE] please add wrap support for prime-agent","comments":6,"created_at":"2026-08-21T20:31:56Z"},{"number":2649,"title":"[FEATURE] Pre-upstream context limit guard — hard-cap input tokens to avoid upstream 400 + client retry storm","comments":6,"created_at":"2026-07-29T11:39:35Z"},{"number":748,"title":"[FEATURE] One consolidated `headroom uninstall` command + document teardown in --help and README","comments":6,"created_at":"2026-06-08T15:42:06Z"},{"number":709,"title":"[BUG] Proactive context expansion injects stale CCR contexts in fast agentic sessions","comments":6,"created_at":"2026-06-06T17:21:32Z"},{"number":975,"title":"[FEATURE] headroom wrap support for Kilo Code (VS Code, CLI, Cloud)","comments":5,"created_at":"2026-06-14T12:15:20Z"}],"discussions":[{"number":4676,"title":"RFC: one label set for request attribution (project, client, host, …) instead of one axis per dimension","comments":0,"category":"Ideas","created_at":"2026-11-07T04:33:35Z"},{"number":4668,"title":"Headroom as a baseline in a study on learned field projections for agent tool outputs","comments":0,"category":"Show and tell","created_at":"2026-11-06T08:49:12Z"},{"number":4612,"title":"Measured byte-level savings on Windows: tool output -71.1%, path list -92.0%, build log +0.7%","comments":0,"category":"Show and tell","created_at":"2026-11-02T08:56:52Z"},{"number":4483,"title":"Headroom with rtk 1.0","comments":0,"category":"General","created_at":"2026-10-25T09:43:19Z"},{"number":4439,"title":"Question about MCP-only mode in Codex Desktop: Who evaluates the need for compression and on what basis?","comments":1,"category":"Q&A","created_at":"2026-10-23T06:24:50Z"},{"number":4312,"title":"Any plan to add support for Mimocode Desktop for Windows?","comments":0,"category":"Ideas","created_at":"2026-10-20T13:32:39Z"},{"number":3961,"title":"OpusBar: a macOS menu bar app for Claude Code and Codex usage, limits and waiting sessions","comments":0,"category":"Show and tell","created_at":"2026-10-04T15:45:48Z"},{"number":3922,"title":"README idea: HVTrust badge linking to Headroom's independent trust profile","comments":0,"category":"Ideas","created_at":"2026-10-02T10:59:30Z"}],"latest_release":{"name":"Release v0.44.0","tag":"v0.44.0","published_at":"2026-11-10T01:58:31Z","body":"## [0.44.0](https://github.com/headroomlabs-ai/headroom/compare/v0.43.1...v0.44.0) (2026-11-09)\n\n\n### ⚠ BREAKING CHANGES\n\n* **packaging:** keep PyTorch extras out of all ([#4067](https://github.com/headroomlabs-ai/headroom/issues/4067))\n\n### Features\n\n* **pipeline:** say whose request an OutcomeSnapshot is ([#4698](https://github.com/headroomlabs-ai/headroom/issues/4698)) ([a2bcbd1](https://github.com/headroomlabs-ai/headroom/commit/a2bcbd101b1391debfd218ec8c63cb72d2bc240a))\n* **providers:** add Hermes agent wrap support ([#934](https://github.com/headroomlabs-ai/headroom/issues/934)) ([7877241](https://github.com/headroomlabs-ai/headroom/commit/7877241d84c93b3ec487e07324245838ddae85cc))\n* **proxy/model-router:** add shadow mode (HEADROOM_MODEL_ROUTER_LOG_ONLY) ([#2395](https://github.com/headroomlabs-ai/headroom/issues/2395)) ([861ef95](https://github.com/headroomlabs-ai/headroom/commit/861ef95620c801c2560a2eacc5773a26e131dfd0))\n* **proxy:** add lossless /v1/compress mode and detect provider by wire shape ([#4617](https://github.com/headroomlabs-ai/headroom/issues/4617)) ([33f067a](https://github.com/headroomlabs-ai/headroom/commit/33f067a243b2e648730c01ae6b9f20cba879f351))\n* **proxy:** expose per-request cost_usd in /stats recent_requests ([#1079](https://github.com/headroomlabs-ai/headroom/issues/1079)) ([#1565](https://github.com/headroomlabs-ai/headroom/issues/1565)) ([84cedbf](https://github.com/headroomlabs-ai/headroom/commit/84cedbf2b4197f09ace9944c50655786dac35b03))\n* **proxy:** expose shared Redis store availability in /health and /metrics ([#4578](https://github.com/headroomlabs-ai/headroom/issues/4578)) ([602ca65](https://github.com/headroomlabs-ai/headroom/commit/602ca65126e12d73ef44d4b1b01bbe1fa3b37080))\n* **proxy:** give turn hooks one conversation id per client conversation ([#4496](https://github.com/headroomlabs-ai/headroom/issues/4496)) ([94a99ed](https://github.com/headroomlabs-ai/headroom/commit/94a99ed20f6fe110e03d2613e9feec42d9547150))\n* **proxy:** report DeepSeek as its own provider in dashboard ([#2565](https://github.com/headroomlabs-ai/headroom/issues/2565)) ([9ad16a7](https://github.com/headroomlabs-ai/headroom/commit/9ad16a77f8b9a7817331aa5e9a9ee04d1e1fc05e))\n* **proxy:** show per-request /stats metadata to token-authenticated callers ([#4168](https://github.com/headroomlabs-ai/headroom/issues/4168)) ([9b2dec5](https://github.com/headroomlabs-ai/headroom/commit/9b2dec56f9882a25fb511dc5f480b047845141f9))\n* **proxy:** unified multi-upstream routing for Anthropic Cloud and local oMLX ([#4597](https://github.com/headroomlabs-ai/headroom/issues/4597)) ([f896161](https://github.com/headroomlabs-ai/headroom/commit/f896161340893dd8e96502d4c309980bed52d3d1))\n* **savings:** carry cumulative actual output_tokens in history checkpoints ([#2921](https://github.com/headroomlabs-ai/headroom/issues/2921)) ([8388ff5](https://github.com/headroomlabs-ai/headroom/commit/8388ff5efd7caf3a827e66bf69449c4a64df05af))\n* **wrap:** add `headroom wrap droid` for Factory Droid ([#4143](https://github.com/headroomlabs-ai/headroom/issues/4143)) ([bb8d18a](https://github.com/headroomlabs-ai/headroom/commit/bb8d18a56abb07ca7e811235c86ea6b626eb1f8b))\n* **wrap:** make the Serena code-memory MCP opt-in ([#4509](https://github.com/headroomlabs-ai/headroom/issues/4509)) ([2649835](https://github.com/headroomlabs-ai/headroom/commit/2649835a51e6d459ac47e8dcb8591e5bf027715b))\n\n\n### Bug Fixes\n\n* **asgi:** stop buffering when the client disconnects (GHSA-mc2f-vg4v-2fh4) ([#4701](https://github.com/headroomlabs-ai/headroom/issues/4701)) ([c6d7081](https://github.com/headroomlabs-ai/headroom/commit/c6d708144ce27abeb08c4c57374b373eebe1951e))\n* **beacon:** enforce the allowlist below the top-level keys ([#4691](https://github.com/headroomlabs-ai/headroom/issues/4691)) ([456288d](https://github.com/headroomlabs-ai/headroom/commit/456288da0765985ca31eed58dbdaef44ff9aa43a))\n* **binaries:** fail closed on HEADROOM_BINARIES_ALLOW_UNVERIFIED=0/false (","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}