W
AI-Wiki
← 开源项目

reticlehq/reticle

已整理
https://github.com/reticlehq/reticle

Reticle 帮助使用 AI 编程代理的开发者确认“代码改完后应用真的能正常工作”,尤其适合需要检查接口失败、状态不一致、重复提交和控制台错误等屏幕上不明显问题的人。它让代理直接验证真实运行中的应用,并给出可追踪的证据和修复位置。

项目简介

Reticle 帮助使用 AI 编程代理的开发者确认“代码改完后应用真的能正常工作”,尤其适合需要检查接口失败、状态不一致、重复提交和控制台错误等屏幕上不明显问题的人。它让代理直接验证真实运行中的应用,并给出可追踪的证据和修复位置。

官方仓库资料

主要语言
TypeScript
许可证
NOASSERTION
默认分支
main
Stars
820
Forks
141
Open Issues
157
仓库状态
正常运行
派生仓库
非 Fork
数据采样
2026/9/23 19:06:33
资料抓取
2026/9/23 19:06:33
首次收录
2026/9/23 19:04:11

Topics:agent-skill · agent-skills · agent-testing · agent-verification · ai-testing-tool · automated-testing · claude-code · claude-skills · jev · playwright-mcp · proof-layer · reticle-mcp · skills-sh · testing-tool

AI 整理 · 基于已抓取的官方资料

核心功能

  • 让 AI 编程代理在真实运行的应用中执行“查看、操作、观察、断言”流程,而不是只根据代码假设任务完成
  • 用自然语言描述要验证的行为,无需手写测试语法
  • 读取网络请求、控制台日志、应用状态、DOM、React 提交流等结构化事件
  • 返回带证据的验证结论:通过、失败或无法判断
  • 失败时可返回相关请求、状态变化、控制台信息以及可能需要打开的文件和行号
  • 支持记录流程,并在后续改动后重新验证
  • 通过 MCP 接入多种编码代理
  • 开发环境使用,README 声称生产环境零字节,SDK 位于开发环境条件下并会被 dead-code eliminated,且运行时保护拒绝在 NODE_ENV=production 下连接
  • 应用数据保持在本机

适用场景

  • 在 AI 代理完成代码修改后,让它用 Reticle 验证改动是否真的生效
  • 检查页面看起来正常但底层网络请求、状态或控制台存在异常的情况
  • 复现 bug、修复 bug,并用相同步骤证明修复有效
  • 记录登录等关键流程,并在后续改动后重复验证
  • 发布前遍历主要路由,发现明显损坏或隐藏失败
  • 检查静默失败的请求、状态与界面不一致、缓存陈旧、重复提交、写入失败但界面继续前进等问题

使用方式

install_unix: curl -fsSL https://raw.githubusercontent.com/reticlehq/reticle/main/install/install.sh | sh install_windows_powershell: irm https://raw.githubusercontent.com/reticlehq/reticle/main/install/install.ps1 | iex project_init: RETICLE_INSTALL_SOURCE=readme npx @reticlehq/server init doctor: npx @reticlehq/server doctor manual_install: - npm install -g @reticlehq/server

  • npx @reticlehq/server setup mcp mcp_client_config: mcpServers: reticle: command: npx args: - @reticlehq/server
  • mcp claude_code_plugin: - /plugin marketplace add reticlehq/reticle
  • /plugin install reticle@reticlehq skills_cli: npx skills add reticlehq/reticle example_prompts: - I changed checkout. Verify it with Reticle before you tell me it's done.
  • The page looks fine but something's off. Use Reticle to check what's happening underneath.
  • Reproduce the bug with Reticle, fix it, then prove the fix with the same steps.
  • Record the login flow with Reticle, then re-verify it after every change.
  • Walk the main routes with Reticle. Tell me anything broken. requirements: - Node 20.11+

技术特点

  • 项目主要语言为 TypeScript
  • 通过 MCP server 与支持 MCP 的编码代理集成
  • 安装器会把 reticle 放到 PATH,并为可识别的编码代理注册 MCP server
  • README 列出的自动配置代理包括 Claude Code、Cursor、Windsurf、VS Code、Zed、Gemini CLI、Copilot CLI、OpenCode、Warp、Kiro、Amazon Q、Cline、Amp、Continue 和 Factory Droid;Codex CLI 会打印需要手动粘贴的 TOML 配置
  • 支持 Web:Next.js App/Pages、Vite + React、CRA、SvelteKit、Svelte、Astro、Vue 3、Preact、plain HTML
  • 支持桌面应用:Electron、Tauri,并可覆盖浏览器工具看不到的 IPC 边界
  • 支持浏览器:Chrome、Edge、Arc、Brave、Opera、Firefox、Safari,以及 Electron 和 Tauri webview
  • 支持状态读取:zustand 和 Redux 无需适配器;README 提到已提供 TanStack Query、Jotai、XState、Valtio、MobX、Recoil、Svelte stores、Pinia
  • 支持操作系统:macOS、Linux、Windows
  • SDK 和 adapters 使用 Apache-2.0;server 使用 FSL,README 说明两年后转换为 Apache-2.0
  • README 提到可通过 pnpm bench 复现实验基准

限制与边界

  • 不是用于跨浏览器渲染验证的工具
  • 不是用于视觉回归测试的工具
  • 不适合验证不属于自己的站点,README 建议这类场景使用 Playwright
  • 对单个操作周围的竞态问题只提供部分能力:可检测 request-never-settled 和 duplicate-request,但不是调度器级竞态分析器
  • 目前还看不到 IndexedDB、Web Workers、closed shadow roots、cross-origin iframes
  • 当证据无法判断时会返回 unknown/couldn't tell,而不是静默通过

README

README 介绍 Reticle 的定位:当 AI 编程代理声称“完成”时,Reticle 会连接真实运行中的应用,驱动操作并读取结构化运行时证据,判断功能是否真的通过。文档提供了一键安装、手动安装、MCP 配置、项目初始化和 doctor 检查命令,并给出可直接对代理说的自然语言使用示例。README 还说明了它与 Playwright 的区别:Reticle 更关注自己正在开发的应用内部状态、网络、控制台和隐藏失败,而 Playwright 更适合外部站点、多浏览器和真实像素验证。项目列出了支持的 Web/桌面框架、代理、浏览器、状态库和操作系统,同时明确说明了无法覆盖的范围、生产环境不连接、数据本地保留以及许可证情况。

关联 Wiki 词条

暂无已建立的词条关联。