reticlehq/reticle

解决的问题

Reticle 为 AI 编码代理提供了一个验证层，防止其发布看似正确但实际损坏的代码。它解决了“静默失败”问题——例如 500 错误、错误的状态值或控制台错误——这些错误在 UI 上不可见，因此对依赖截图或仅 DOM 工具的代理来说是不可见的。

工作原理

Reticle 在运行中的 Web 应用内部运行一个仅限开发使用的 SDK。它不从外部观察应用，而是监控内部程序事件，包括网络调用、状态存储、信号和 React fiber 树。当代理执行操作时，Reticle 会将这些内部事件与一组谓词（例如："POST 请求是否返回了 200？"）进行比对，并返回确定性的通过/失败判断，同时提供需要修复的代码中确切的 file:line。

适用人群

使用 AI 编码代理（如 Claude Code、Cursor、Copilot 或任何 MCP 兼容代理）构建基于 React、Vue、Svelte、Preact、Astro 或 Electron 和 Tauri 等框架的 Web 和桌面应用程序的开发者。

核心亮点

• 内部可见性：可访问对视觉模型和浏览器代理不可见的网络响应、应用状态和控制台日志。
• 确定性验证：使用结构化事件而非 LLM 推测或截图，消除不确定性（flake）。
• 代理集成：作为 MCP 服务器运行，并提供一个斜杠命令（/reticle），可无缝集成到代理的工作流中。
• 精准定位：提供失败代码的精确 file:line，减少代理修复 bug 所需的工具调用次数。
• 回归测试：只需录制一次流程，即可在后续每次编辑中确定性地重放。