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 旗標的會話持續性與可設定的過期時間。