reticlehq/reticle

这是什么？

核心功能

• 01为编程代理提供观察、操作、监听和断言运行中应用的工具。
• 02给出 yes、no 或 unknown 的结论，并附带请求、状态变化和 file:line 等证据。
• 03从页面内部读取网络响应、状态库数据、控制台输出和 React 渲染信息。
• 04无需 AI 模型即可确定性地回放已保存的流程。
• 05提供 `reticle gate` 命令，在 CI 中要求受影响代码有通过的运行记录。
• 06生产构建不包含 SDK，本地桥接服务仅绑定 127.0.0.1。

适用场景

• 验证代理完成的结账或登录改动在真实运行的应用中是否生效。
• 发现隐藏问题，例如成功提示背后实际是 500 错误。
• 固定关键用户流程，防止后续修改悄然破坏功能。
• 在合并前通过 CI 要求已覆盖的流程完成验证。

快速上手

1. 1

   用 npm 全局安装 reticle 命令

   npm install -g @reticlehq/server
2. 2

   将 Reticle 注册到你的编码代理

   reticle setup mcp
3. 3

   重启编码代理，然后在你的应用文件夹中运行 init

   reticle init

使用前须知

• !服务端和命令行工具采用 FSL-1.1-ALv2 许可证，属于源码可见但并非 OSI 认可的开源协议，两年后转为 Apache-2.0。
• !需要 Node 20.11 或更高版本、本地运行的开发服务器，以及支持 MCP 的编码代理。
• !它需要驱动 Chromium 浏览器，并且匿名使用统计默认开启，除非你手动关闭。

标签

常见问题

reticle 是什么？

让 AI 编程代理在真实运行的 Web 或桌面应用中验证改动，并返回通过、失败或无法判定的结论。 Reticle 针对 AI 辅助编程中的一个常见问题：代理写完代码后往往假定已经生效，却从不打开应用实际检查。它在应用中嵌入一个仅用于开发环境的 SDK，并通过 MCP 向代理暴露工具，使其能够观察、操作并断言正在运行的应用。

reticle 可以免费使用吗？用的什么许可证？

reticle 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

reticle 还在维护吗？

活跃维护中。reticle 最近一次提交是在 2026年10月21日。

reticle 适合用来做什么？

验证代理完成的结账或登录改动在真实运行的应用中是否生效。 发现隐藏问题，例如成功提示背后实际是 500 错误。 固定关键用户流程，防止后续修改悄然破坏功能。 在合并前通过 CI 要求已覆盖的流程完成验证。

reticle 怎么安装和运行？

用 npm 全局安装 reticle 命令: npm install -g @reticlehq/server 将 Reticle 注册到你的编码代理: reticle setup mcp 重启编码代理，然后在你的应用文件夹中运行 init: reticle init

在哪里获取 reticle？

源代码和安装说明在 GitHub 上：https://github.com/reticlehq/reticle