Ralph Build. Auto Guarded Python Harness

Ralph Harness 是一个轻量级的 Python 工具包，专为运行 Claude Code、Codex CLI、Gemini CLI、Cursor 等编码智能体而设计，在受控的本地循环中实现高效协作。它无需托管后端、无需 Token 服务，也不绑定特定智能体，让开发者完全掌控开发流程。

核心功能

Ralph Harness 提供了一种基于规范驱动的循环机制，每次运行都使用全新的上下文环境，确保智能体从零开始执行任务。它集成了 Git 钩子、CI 验证和覆盖率门控，自动检查代码质量与测试覆盖，只有通过所有门控的代码才会被提交。

主要特性

• 无限智能体支持：无缝集成 Claude Code、Codex CLI、Gemini CLI、Cursor 等主流编码智能体，无锁定风险。
• 本地化运行：所有操作在本地完成，数据不外泄，安全可控。
• 硬性限制与门控：设置严格的执行上限（如时间、步骤），并通过 Git 钩子和 CI 验证确保代码质量。
• 轻量无依赖：纯 Python 实现，无需复杂配置，即装即用。
• 规范驱动：通过 YAML 或 JSON 规范定义任务，智能体按规范执行，结果可重复。

适用场景

• AI 辅助开发：在本地项目中利用多个智能体协同编码，同时保持代码质量。
• 自动化测试与验证：自动运行测试并检查覆盖率，确保每次提交都符合标准。
• 研究与实验：快速迭代智能体工作流，无需担心环境污染或资源泄露。

Ralph Harness 让开发者成为智能体的“指挥官”，在无限循环中保持人类控制，是 AI 编程时代的理想工具。