reticlehq/reticle

AI agents can generate code, but still struggle to understand what they build. Reticle brings Jev-style machine-native runtime perception to web & desktop applications.

解决的问题

编码代理通常基于它们编写的代码假设变更有效，但很少验证实际运行的应用程序。这会导致“静默失败”——例如损坏的弹出窗口、500 错误或 UI 错误——这些问题通常只有人类开发者在手动 QA 时才会发现。Reticle 提供了一种让代理从乐观假设转向具体验证的方法，通过驱动实际应用程序并观察其内部状态来实现。

运作方式

Reticle 使用安装在应用程序中的开发专用 SDK（支持 React, Next.js, Vue, Svelte 和 Angular 等框架），以及一个连接运行中应用程序与编码代理的桥接器。

与仅能看到表面（DOM）的传统测试工具不同，Reticle 从内部读取应用程序。它允许代理观察网络响应、应用程序状态（例如 Zustand, Redux, Pinia）、控制台错误以及与 UI 元素相关的特定源代码行。当代理执行操作时，Reticle 会返回一个判断结果——yes、no 或 unknown——并提供网络状态码或状态变更等证据作为支持，而不仅仅是截图。

目标对象

使用 AI 编码代理（如 Claude Code, Cursor, Windsurf 或 VS Code）并希望自动验证其在 Web 或桌面（Electron, Tauri）应用程序中工作成果的开发者。

特色亮点

  • 内部可见性：可查看屏幕上隐藏的网络请求、状态存储库和控制台日志。
  • 代理原生：通过 MCP (Model Context Protocol) 整合，为代理提供观察、行动和断言的工具。
  • 确定性重播：允许将成功的旅程保存为“流程”，无需 AI 模型即可重新检查。
  • CI 整合：包含 reticle gate 指令，可让破坏先前保存流程的变更失败。
  • 生产环境安全：SDK 会从生产构建中移除，且仅监听本地回送地址。

相关

  • 项目
    rajudandigam/agent-inspect

    agent‑inspect 是一个 TypeScript/Node.js 库和 CLI，将单次 AI 代理运行记录为本地 JSON‑Lines 跟踪日志。它支持查看嵌套执行树、在 CI 中运行确定性检查，并打包脱敏、哈希验证的证据资产，无需任何 SaaS 账户或数据上传。

  • 项目
    CyberStrikeus/CyberStrike

    CyberStrike 是一个开源 AI 智能体，可将任何 LLM（Claude、GPT、Gemini 等）转换为自主渗透测试平台。它添加了专注于安全的“智能层”，提供 13 多个专业智能体和 7,600 多个已签名的安全技能文件，支持 150 多个 AI 提供商（包括离线模型），并可以在本地或远程 Bolt 服务器上编排实际工具。TUI、可选的 Web UI 和内置的 HackBrowser 完善了工作流程。

  • 项目
    Panniantong/Agent-Reach

    Agent Reach 是一个基于 Python 的能力层，让任何命令行 AI 代理能即时浏览网页、获取 YouTube 字幕、阅读 RSS 订阅、查询 GitHub 以及访问多种社交平台。它会自动安装各网站的最佳开源 CLI 工具，将凭证存储在本地，并提供 `doctor` 指令来检查系统健康。用户只需对代理输入一行指令即可安装，随后代理便能以自然语言提问（如“总结这个视频”），无需手动编写爬虫代码。

  • 项目
    iamfakeguru/agent-md

    agent-md 是一个轻量级框架，通过安装规则文件、git-hooks 和辅助脚本，将 AI 编码助手（如 Claude Code、Codex、Cursor、Windsurf）转变为合约驱动的代理。它提供单一事实来源的 markdown 文件 (AGENT.md) 以及强制执行检查（类型检查、lint、测试、视觉截图、状态更新），在满足必要证据前会阻挡模型完成任务。

  • 项目
    nrslib/takt

    TAKT 是一个基于 Node 的 CLI，通过用户定义的 YAML 工作流协调 AI 编码代理。每个步骤（规划、实现、审查、修复）都在具有独立角色、权限和输出契约的隔离 Git 工作树中运行，确保审查循环并生成可追溯的日志。支持多种提供者（Claude、Codex、Pi、DeepSeek、Cursor、Copilot 等），并与 GitHub/GitLab 问题、Web UI 和 Discord 社区集成。