Headroom - AI Agent 上下文压缩层，减少60-95%Token

Headroom — AI Agent 上下文压缩层

Headroom 是一个本地运行的 AI Agent 上下文压缩工具，能在保持答案准确性的前提下减少 60–95% 的 Token 消耗。支持 Python 和 TypeScript，可作为库、代理、MCP Server 使用。

核心能力

• 6 种压缩算法 — SmartCrusher（JSON）、CodeCompressor（AST）、Kompress-base（文本ML模型）等
• 可逆压缩（CCR） — 原始内容本地保存，LLM 按需取回，不丢信息
• 跨 Agent 共享记忆 — Claude Code、Codex、Cursor 等多 Agent 共享上下文，自动去重
• headroom learn — 自动挖掘失败会话，将修正写入 CLAUDE.md / AGENTS.md

使用方式

模式	命令	说明
库调用	compress(messages)	嵌入任意 Python/TS 应用
代理	headroom proxy --port 8787	零代码改动，任何语言
Agent 包装	headroom wrap claude	一键包装主流编码 Agent
MCP Server	headroom mcp install	任何 MCP 客户端可用

实测压缩效果

场景	压缩前	压缩后	节省
代码搜索（100条）	17,765	1,408	92%
SRE 故障排查	65,694	5,118	92%
GitHub Issue 分类	54,174	14,761	73%
代码库探索	78,502	41,254	47%

Agent 兼容

Claude Code ✅ · Codex ✅ · Cursor ✅ · Aider ✅ · Copilot CLI ✅ · OpenClaw ✅

任何 OpenAI 兼容客户端均可通过 headroom proxy 接入。

技术栈

Python 3.10+ · HuggingFace Kompress-base 模型 · Apache 2.0 开源协议