Open Ralph Wiggum

Open Ralph Wiggum (ralph) wraps any supported AI coding agent in an autonomous loop: it sends the same prompt on every iteration, and the agent self-corrects by observing the state of the repo. The loop ends when the agent outputs a configurable completion promise (e.g. <promise>COMPLETE</promise>).

Supported agents: Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode (default).

Installation

Prerequisites

• Bun runtime
• At least one of these AI coding agent CLIs installed and authenticated:
  • claude — Claude Code
  • codex — OpenAI Codex CLI
  • copilot — GitHub Copilot CLI
  • cursor-agent — Cursor Agent CLI
  • opencode — OpenCode