{"full_name":"headroomlabs-ai/headroom","owner":"headroomlabs-ai","name":"headroom","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":[],"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-10T05:22:56Z","metrics":{"stars":79281,"forks":6198,"watchers":212,"issues":1327,"prs":3241,"releases":177,"issues_open":null,"issues_closed":null,"prs_open":null,"prs_closed":null,"prs_merged":null,"discussions":92},"growth":{"day":{"stars":88,"forks":6,"base_day":"2026-11-09"}},"history":{"dates":["2026-11-09","2026-11-10"],"stars":[79193,79281],"forks":[6192,6198],"watchers":[212,212],"issues_open":[null,null],"prs_open":[null,null]},"boards":{},"same_owner":[],"issues":[{"number":777,"title":"[FEATURE] headroom wrap support for Kiro IDE","comments":7,"created_at":"2026-06-09T07:27:39Z"},{"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":3259,"title":"[BUG] Proxy hangs ~180-220s on upstream_connect (first_byte: null) then 502s — persists with HTTP2=0 and max_keepalive=0","comments":5,"created_at":"2026-08-25T20:06:27Z"},{"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.43.1","tag":"v0.43.1","published_at":"2026-11-05T19:34:01Z","body":"## [0.43.1](https://github.com/headroomlabs-ai/headroom/compare/v0.43.0...v0.43.1) (2026-11-05)\n\n\n### Bug Fixes\n\n* **ccr:** keep the in-memory order queue from evicting re-stored entries ([#4545](https://github.com/headroomlabs-ai/headroom/issues/4545)) ([c6f5bf9](https://github.com/headroomlabs-ai/headroom/commit/c6f5bf9549e9b357e9c2369d4e04bc437f5e180d))\n* **memory:** read the relation key the memory_save schema advertises ([#4647](https://github.com/headroomlabs-ai/headroom/issues/4647)) ([7592e68](https://github.com/headroomlabs-ai/headroom/commit/7592e681459f14a2041eb5f524a658cb6ad1dd92))\n* **memory:** replace the HNSW vector when a memory is re-indexed ([#4649](https://github.com/headroomlabs-ai/headroom/issues/4649)) ([ee638f9](https://github.com/headroomlabs-ai/headroom/commit/ee638f9532b3788bacd13ed8d26dd0faf0740baf))\n* **openclaw:** accept 12-character hashes in headroom_retrieve ([#4640](https://github.com/headroomlabs-ai/headroom/issues/4640)) ([8d3e9e5](https://github.com/headroomlabs-ai/headroom/commit/8d3e9e5ca7cd645eb73084b848edbea5fc796e1a))\n* **ort:** avoid implicit runtime discovery from the workspace ([#4570](https://github.com/headroomlabs-ai/headroom/issues/4570)) ([69fbd23](https://github.com/headroomlabs-ai/headroom/commit/69fbd2390d9c8b0fa1f59fb8314bc9b8f01b1a55))\n* **proxy:** bound the model-keyed tokenizer, beacon and litellm caches ([#4497](https://github.com/headroomlabs-ai/headroom/issues/4497)) ([e51b806](https://github.com/headroomlabs-ai/headroom/commit/e51b8065a4a2aa3a3c7f266c1cb8d8bde6b568d0))\n* **proxy:** use HTTP/1.1 client for ChatGPT streaming and model metadata ([#4006](https://github.com/headroomlabs-ai/headroom/issues/4006)) ([e1becdf](https://github.com/headroomlabs-ai/headroom/commit/e1becdf7329bf4ca03874b9f512ac19837ca29c2))\n* **release:** normalize damaged release PR envelopes before detection ([#4664](https://github.com/headroomlabs-ai/headroom/issues/4664)) ([917edc6](https://github.com/headroomlabs-ai/headroom/commit/917edc62230c3c4a8a415e2053da68dab1f003dd))\n* **router:** keep tagged blocks out of the lossy size-gate fallback ([#4543](https://github.com/headroomlabs-ai/headroom/issues/4543)) ([f333edf](https://github.com/headroomlabs-ai/headroom/commit/f333edf20f0d7acf5ea67e040c1f58539a0edd4d))\n* **router:** log the ONNX fallbacks at info instead of warning ([#4535](https://github.com/headroomlabs-ai/headroom/issues/4535)) ([db30d82](https://github.com/headroomlabs-ai/headroom/commit/db30d82dfffdb3bbe4d60a0e0bfe88640e58470f))\n\n\n### Dependencies\n\n* bump the npm-minor-patch group across 3 directories with 6 updates ([#4662](https://github.com/headroomlabs-ai/headroom/issues/4662)) ([8f104f8](https://github.com/headroomlabs-ai/headroom/commit/8f104f8e298c85ff0005f2fd4848eea95f32b7c7))\n\n<!-- headroom-teams-footer -->\n\n---\n\n**Want more savings?** Headroom Enterprise saves more for teams and enterprises. Talk to us at [hello@headroomlabs.ai](mailto:hello@headroomlabs.ai) or [headroomlabs.ai](https://headroomlabs.ai).\n"},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-10T09:35:25Z","history_start":"2026-09-06"}