frankbria/ralph-claude-code

Autonomous AI development loop for Claude Code with intelligent exit detection

What it solves

Ralph 为 Claude Code 提供一个自主开发循环，让它能够在不需要持续人工干预的情况下，迭代改进项目直至完成。它通过自动化执行循环，解决了手动提示‑响应循环的问题，同时实现了防止无限循环、API 过度使用与成本失控的保护机制。

How it works

Ralph 将 Claude Code 包裹在持续的循环中：它从 PROMPT.md 文件读取项目目标，执行 AI，透过任务列表跟踪进度，并评估项目是否完成。它使用「双条件退出门」——必须同时满足启发式完成指标且 AI 明确返回 EXIT_SIGNAL: true 才会停止。为确保稳定性，系统加入错误检测断路器、API 调用速率限制，以及会话管理以在迭代间保留上下文。

Who it’s for

使用 Claude Code，且希望自动化根据 PRD、GitHub Issue 或技术规格实现功能或修复 Bug 的开发者，无需手动驱动每一步循环。

Highlights

  • Autonomous Loop: 持续根据项目需求执行 Claude Code。
  • Intelligent Exit Detection: 通过双条件检查（启发式 + 明确信号）防止过早退出。
  • Task Integration: 直接从 PRD、GitHub Issue 或交互式 ralph-enable 向导导入需求。
  • Safety Guards: 包含速率限制、卡住循环的断路器，以及自动 git 备份分支。
  • Sandbox Support: 能在隔离的 Docker 或 E2B 云端沙盒中运行 Claude Code。
  • Session Management: 支持 --resume 标志的会话持续性与可配置的过期超时。