Headroom

Headroom 是 Headroom Labs 在 GitHub 上开源的工具，专门压缩 AI 代理要读的东西：工具输出、日志、检索片段、文件和对话历史，压缩完再交给大模型。README 的例子是一段 10,144 个 token 的日志压到 1,260 个，关键的报错行还在。它按内容类型挑压缩方法，JSON、源代码和普通文字各有一套；原文存在本机缓存里，模型需要时可以调回完整内容。用法有好几种：在 Python 或 TypeScript 里直接调用，开一个本地代理服务，一条命令“包住”Claude Code、Codex、Cursor 等编程代理，或者作为 MCP 服务接入。它特别的地方是压缩在你自己电脑上做，README 说压缩时不会把提示词或文件内容发到任何地方。

适合谁：编程代理用得多、想省 token 费用的开发者。不写代码的读者用不上。

使用前提：用 uv、pip 或 npm 安装。压缩在本机进行，但压缩后的内容照样会发给你原来用的模型服务，费用照常按那边算。原始日志和文件会缓存在你电脑上。“包住”模式会接管代理的输入输出，用 headroom unwrap 可以撤回；headroom learn 会把从失败会话里学到的修正写进 CLAUDE.md、AGENTS.md 这类说明文件，写进去之前请先看一遍。README 里另有面向团队的 Headroom for Teams，具体内容和价格以官网为准。Apache-2.0 许可。

以上根据项目公开说明整理，本站没有实际测试。