RTK 命令输出优化器

在 AI 编码助手读取终端输出前进行过滤与压缩,减少上下文中的冗余内容。

源仓库
rtk-ai/rtk
Star 数
★ 84k
最近更新
今天
License
Apache-2.0
主语言
Rust

30 秒速览

运行形态
命令行工具Agent 插件 / 技能自托管服务
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
Shell / 命令行本地文件系统
典型场景
使用 Claude Code 或 Codex 编写代码、频繁查看 Git 状态和差异的开发者,希望减少终端输出进入上下文的内容。
不适合
  • 希望压缩 Read、Grep、Glob 等内置工具输出的团队
  • 需要只用 Apache-2.0 组件且要运行压缩引擎的团队

这个 Agent 能做什么,适合哪些场景?

RTK 是一个 Rust 命令行工具,通过钩子将受支持的 shell 命令改写为 rtk 等效命令。它运行原命令并按命令类型过滤、分组、截断或去重输出,再将精简结果交给编码助手。README 列出 Git、测试、搜索、构建、容器和云工具等 100 多种命令,并提供 Claude Code、Codex、Gemini CLI、Cursor 等工具的集成方式。安装后可通过 rtk gain 查看节省统计,也可直接运行 rtk 子命令。可选的 rtk-proxy 是独立守护进程,用于处理代理配置的模型 API 流量;基础命令过滤不需要该组件。

RTK 安装面向编码助手的钩子或规则,在助手通过 Bash 工具调用 shell 命令时,将受支持的命令改写为对应的 rtk 命令。RTK 执行命令并将输出交给相应过滤器,例如把 git status 压缩为按状态分组的摘要、让测试命令只显示失败项、或将文件列表转为树状格式。过滤后的文本返回给助手,并可通过 rtk gain、rtk discover 和 rtk session 查看统计或发现可优化命令。README 指出,内置的 Read、Grep、Glob 工具调用不会经过该 Bash 钩子。

  1. 使用 Claude Code 或 Codex 编写代码、频繁查看 Git 状态和差异的开发者,希望减少终端输出进入上下文的内容。
  2. 在大型测试套件中运行 cargo test、npm test 或 pytest 的团队,希望优先看到失败项而非全部通过记录。
  3. 使用 rg、grep、ls 或 tree 浏览大型代码库的工程师,希望输出按文件分组或精简显示。
  4. 维护多语言项目的团队,希望用同一 CLI 处理 Rust、JavaScript、Python、Go 等常见开发命令。
  5. 需要监测命令输出优化效果的开发者,可用 rtk gain 查看统计,并用 rtk discover 寻找尚未覆盖的节省机会。

如何安装或部署这个 Agent?

RTK 提供 Homebrew、Windows Package Manager 和安装脚本等安装方式。安装后可用 rtk --version 检查版本,并运行 rtk gain 确认安装结果。也可选择仅含 Apache-2.0 许可组件的 rtk-oss 版本;README 说明完整 rtk 版本包含 BUSL-1.1 许可的压缩引擎。

brew install rtk
winget install rtk-ai.rtk
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
rtk --version
rtk gain

如何使用这个 Agent?

为所用编码助手安装集成,然后重启该工具。以下示例展示 Claude Code 或 Copilot 的默认初始化,以及 Codex 的初始化。配置生效后,助手通过 Bash 执行的受支持命令会自动改写;也可以直接调用 rtk 命令。内置读取、搜索和文件匹配工具不经过该钩子。

rtk init -g
rtk init -g --codex
git status
rtk gain

这个 Agent 有哪些优点和局限?

优点
  • 单个 Rust 二进制文件即可提供 100 多种命令过滤器,README 称命令处理额外开销低于 10 毫秒。
  • 为 Claude Code、Codex、Gemini CLI、Cursor 等多种编码工具提供明确的初始化集成。
  • 按命令类型处理输出,包括测试失败筛选、Git 摘要、分组和重复日志折叠。
  • 提供 rtk gain、rtk discover 和 rtk session 等命令观察使用和优化机会。
局限
  • 自动改写只作用于 Bash 工具调用;助手内置的 Read、Grep 和 Glob 调用不会经过钩子。
  • README 按字节除以 4 估算 token 数;百分比可参考,但绝对 token 数是近似值。
  • 完整发行版包含 BUSL-1.1 许可的引擎;将 RTK 或衍生产品作为商业服务提供给第三方不在其许可授予范围内。
  • 代理流量优化需要单独的 rtk-proxy 守护进程,且 README 目前只明确列出可通过 rtk claude 启动并验证流量重定向的 harness。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
RTK 命令输出优化器 当前 62 · 存在缺口 命令行工具免费 ★ 84k 今天 Rust Codex · Claude Code
破坏性命令守卫 (dcg) 61 · 存在缺口 命令行工具免费 ★ 6.2k 今天 Rust Codex · Claude Code
Diri 59 · 缺口较多 桌面应用免费 + 模型费 ★ 454 今天 Rust Codex · Claude Code
Plannotator 78 · 表现良好 命令行工具免费版 + 付费版 ★ 9.5k 今天 TypeScript Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
存在缺口
62/ 100 五分制 3.1 / 5
信任安全 13/29
可靠稳定 6/14
适用触发 14/18
规范维护 14/18
有效结果 9/13
证据核验 6/8
查看各维度的扣分理由
信任安全13 / 29 · 2.2/5

README 说明默认不收集命令或文件内容,遥测需显式启用;Hermes 插件只处理 terminal 命令,并在重写失败时保留原命令。安装脚本、代理转发和初始化写入配置会产生外部影响,材料未给出完整权限清单或撤销细节,因此最小权限、敏感数据处理、回滚与外部影响仅部分得分;贡献者安全流程和私报渠道清楚,但发布者身份未验证,来源归属仍有限。

可靠稳定6 / 14 · 2.1/5

材料说明有多平台 CI、安全检查及失败时退回原命令的设计,Hermes 测试文件覆盖多种错误路径;但 CI/CD 描述与实际工作流文件只部分相互印证,且没有提供依赖锁文件或依赖可用性证据,故自洽性和依赖可用性得分较低。错误警告和回退行为有具体说明。

适用触发14 / 18 · 3.9/5

README 针对多种编码代理、开发命令及操作系统提供明确场景和设置方式,并指出钩子仅作用于 Bash 调用、内置 Read/Grep/Glob 不经过钩子等边界。不同代理使用不同集成机制,覆盖范围广;但描述声称支持 18 种工具,表格列出数量与声明不完全一致,环境兼容性信息虽较丰富仍依赖外部指南。

规范维护14 / 18 · 3.9/5

README 结构清晰,提供安装、快速开始、操作说明、故障排查入口、示例和许可说明;Cargo 清单给出版本与 Rust 版本要求,安全策略也描述维护流程。扣分原因是安装细节、更新记录和部分限制依赖外部文档,且 Apache 元数据与 README 所述引擎及代理 BUSL 许可并存,需按发行版确认许可边界;维护负责人列出,但发布者身份未验证。

有效结果9 / 13 · 3.5/5

命令输出压缩、失败摘要、统计仪表盘和可配置管线展示了可直接用于开发代理的价值;README 也区分输出缩减与账单节省,并说明 token 数按 bytes/4 估算。收益比例仍主要是项目方陈述,未由所给材料中的独立测量结果支撑;代理流量压缩与命令输出过滤的成本和适用差别需读者自行评估。

证据核验6 / 8 · 3.8/5

README 将功能、遥测、安装和许可主张链接到具体文档;Cargo 清单、许可证、安全策略及 Hermes 测试代码提供部分交叉支撑。节省比例、支持范围等关键主张在材料中未获独立验证;不过 README 明确区分可测的 bash 输出缩减、近似 token 数与总账单,事实和估算的区分较好。

风险与缓解建议
  • 材料未提供独立测量来验证 60–90% 节省主张;README 说明 token 绝对数按 bytes/4 估算,不能直接视为账单降幅。
  • 安装与代理功能会改写命令或配置,并可能将代理流量转发至模型提供方;部署前应确认所选发行版、配置及许可证边界。
  • README 声称支持 18 种 AI 工具,但表格列出的工具数量与该说法不完全一致。
证据充分度:低 评估于 2026年10月20日 审查版本 5538d72b1d0b
查看完整评分方法 →

常见问题

RTK 能让 API 账单按它报告的比例下降吗?
不能直接这样推断。RTK 优化的是助手读取的 Bash 输出;输入 token 还包括提示词和对话历史,账单也计算输出 token。RTK 的 token 数按字节除以 4 估算。
RTK 会处理助手的所有文件读取和搜索吗?
不会。钩子只作用于 Bash 工具调用;内置 Read、Grep 和 Glob 工具不会经过它。可在 shell 中使用 cat、rg、find,或直接运行 rtk read、rtk grep、rtk find。
使用基础命令过滤需要配置 API 密钥吗?
README 的安装和快速入门没有要求 API 密钥。可选的 rtk-proxy 用于代理助手与模型提供商之间的 API 流量。
RTK 会收集命令或文件内容吗?
README 表示 RTK 不收集命令内容或文件内容;匿名遥测默认关闭,只有显式运行 rtk telemetry enable 后才会发送。
rtk 的所有组件都采用 Apache-2.0 许可吗?
不是。README 将 CLI 标为 Apache-2.0,同时说明完整发行版链接 BUSL-1.1 的 rtk-engine;rtk-oss 只含 Apache-2.0 组件,但不含引擎。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents