TokenJuice：为AI编程代理瘦身的终端输出压缩工具

TokenJuice是一款开源工具，旨在通过智能压缩终端命令输出来节省AI编程代理（如Claude Code、Codex）的上下文窗口空间。它采用非侵入式设计，不改变命令执行过程，通过规则引擎压缩冗余输出，保留关键信息，同时支持主流框架原生集成和安全阀机制确保原始输出可获取。

AI编程代理执行命令时，终端输出常包含重复行、格式化噪声等冗余信息，占据宝贵上下文窗口，推高token消耗和推理成本。TokenJuice应运而生，核心理念是"your LLM needs a diet"，通过智能压缩层减少传回AI的token数量。

TokenJuice遵循"绝不改变原始命令执行"原则，工作流程分三阶段：1.原始执行：命令原封不动传递给shell；2.智能压缩：规则引擎识别并移除冗余内容，保留关键信息；3.压缩结果回传：通过原有钩子返回给代理，过程对代理透明，无需适配。

TokenJuice的压缩基于分层规则引擎，优先级从低到高为内置规则、用户级规则、项目级规则。每条规则以JSON定义匹配条件和策略，相比LLM摘要方案具有确定性强、延迟低、无额外成本的优势，开发者可定制规则。

TokenJuice支持Claude Code和Codex CLI原生集成，一条命令即可完成安装（如tokenjuice install claude-code），智能保留用户已有设置。提供诊断工具（tokenjuice doctor hooks）和验证工具（tokenjuice verify）确保集成正常。

TokenJuice提供多层安全阀：1.--raw/--full标志跳过压缩；2.--store标志存储原始输出到本地，可通过tokenjuice cat查看；3.机器调用者可设置"raw":true全局禁用压缩，避免信息瓶颈。

压缩效果因命令类型而异：构建工具输出压缩率60%-80%，测试框架输出压缩率取决于通过/失败用例比例。适用于日常开发、CI/CD辅助审查等频繁终端交互场景，对简洁命令无负面影响。

TokenJuice填补AI编程代理工具链空白，通过规则引擎、非侵入集成和安全阀提供务实解决方案。项目处于活跃开发阶段，内置规则集持续扩展，未来将随AI代理普及发挥更重要作用。