产品简介
ralph-loop 这是一个能自动化软件开发任务的AI代理循环工具，它通过迭代处理任务列表实现长时间自动编程。适合希望用AI自动完成复杂开发工作流，特别是需要AI持续数天工作的开发者。
核心功能
- 在Docker沙盒中隔离运行AI代理，安全可靠
- 默认支持Claude Code，可配置其他AI代理CLI（如Cursor、Codex）
- 提供可配置的启动脚本，便于适应不同开发环境
- 内含“prd-creator”技能，帮助从需求生成PRD和任务列表
- 支持详细的沙盒调试与网络端口配置
快速开始
- 第一步：在项目目录运行 `npx @pageai/ralph-loop` 安装Ralph。
- 第二步：使用“prd-creator”技能，向AI代理描述需求以生成产品需求文档(PRD)和任务列表。
- 第三步：运行 `./ralph.sh --login`，在Docker沙盒中完成AI代理的认证登录。
- 第四步：运行 `./ralph.sh -n 50` 启动Ralph循环，开始自动执行任务。
界面预览
与其他方案对比
| 对比项 | ralph-loop | 同类方案 |
|---|---|---|
| 运行环境安全性 | 强制在Docker沙盒中运行AI代理，提供隔离安全的执行环境。 | 通常直接在宿主机环境运行，缺乏沙盒隔离，存在安全风险。 |
| 可定制性与灵活性 | 提供可修改的脚本，允许用户自定义开发环境、代理CLI和迭代规则，适配性强。 | 很多工具是开箱即用，但配置选项有限，难以深度定制工作流。 |
| 长时间任务支持 | 设计用于长周期运行（可循环数十甚至上百次迭代），支持AI持续编程数天。 | 大多数AI编程辅助工具适用于单次对话或短期任务。 |
适合谁用
- 需要自动化执行复杂软件开发任务的个人开发者
- 希望构建AI自动化工作流的技术团队
- 追求将AI代理融入长时间开发流程的工程师
下载与版本
当前最新版本为 main，发布于 。支持 Windows、macOS、Linux。
⚠️ 注意：本项目仅提供源代码下载，不包含可直接运行的安装包（exe/dmg/apk 等。下载后需要自行编译构建才能使用，适合有一定开发经验的用户。如果你不熟悉编译流程，建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用，请遵守相关法律法规。
- 请尊重内容创作者版权，勿将下载内容用于商业或非法传播。
- 项目源码地址：https://github.com/PageAI-Pro/ralph-loop