by mikeyobrien
An improved implementation of the Ralph Wiggum technique for autonomous AI agent orchestration
# Add to your Claude Code skills
git clone https://github.com/mikeyobrien/ralph-orchestratorA hat-based orchestration framework that keeps AI agents in a loop until the task is done.
"Me fail English? That's unpossible!" - Ralph Wiggum
Documentation | Getting Started | Presets
npm install -g @ralph-orchestrator/ralph-cli
brew install ralph-orchestrator
cargo install ralph-cli
# 1. Initialize Ralph with your preferred backend
ralph init --backend claude
# 2. Plan your feature (interactive PDD session)
ralph plan "Add user authentication with JWT"
# Creates: specs/user-authentication/requirements.md, design.md, implementation-plan.md
# 3. Implement the feature
ralph run -p "Implement the feature in specs/user-authentication/"
<img width="1513" height="1128" alt="image" src="https://github.com/user-attachments/assets/ce5f072f-3d81-44d8-8f2f-88b42b33a3be" />
Ralph iterates until it outputs LOOP_COMPLETE or hits the iteration limit.
For simpler tasks, skip planning and run directly:
ralph run -p "Add input validation to the /users endpoint"
Alpha: The web dashboard is under active development. Expect rough edges and breaking changes.
Ralph includes a web dashboard for monitoring and managing orchestration loops.
ralph web # starts both servers + opens browser
ralph web --no-open # skip browser auto-open
ralph web --backend-port 4000 # custom backend port
ralph web --frontend-port 8080 # custom frontend port
Requirements: Node.js >= 18 and npm. On first run, ralph web will auto-detect missing node_modules and run npm install for you.
To set up Node.js:
# Option 1: nvm (recommended)
nvm install # reads .nvmrc
# Option 2: direct install
# https://nodejs.org/
For development:
npm install # install dependencies
npm run dev # run both servers (backend:3000, frontend:5173)
npm run test:server # backe...