vincentkoc/tokenjuice

解决的问题

Tokenjuice 解决了 AI 代理工作流中的「文本墙」问题。当代理运行终端命令（如 git status 或 docker build）时，生成的输出通常杂乱且过长，浪费上下文窗口的 token，并可能使 LLM 混淆。Tokenjuice 在不改变命令实际行为的前提下，将这些输出压缩为更小、更有意义的负载。

工作原理

它作为一个确定性输出压缩器运行。在命令执行后观察其输出，并应用基于规则的缩减器来缩小负载。这些规则以可检查的 JSON 格式存储，而非依赖概率性的 LLM 摘要。用户仍可通过显式指定 --raw 或 --full 标志，或通过可选的工件存储访问原始完整输出。

适用人群

构建或使用以终端为中心的 AI 代理和工具（如 Claude Code、Cursor、Aider 或 OpenHands）的开发者，希望通过对命令输出进行清理来优化 token 使用并提高代理可靠性。

特色

• 确定性压缩：使用基于规则的缩减器，而非依赖 LLM 的「感觉」，确保输出一致。
• 广泛集成支持：为大量 AI 编程代理和 IDE 提供一键安装。
• 上下文高效：最小化输出浪费，减少无用重试的需要。
• 隐蔽运行：保持 shell 体验不变，同时为宿主集成提供轻量级包装。