ralph-orchestrator | SkillsLLM

ralph-orchestrator

Pending

An improved implementation of the Ralph Wiggum technique for autonomous AI agent orchestration

1,604stars

169forks

Rust

Added 1/17/2026

View on GitHub Download ZIP

AI Agentsaiai-agentsai-agents-frameworkai-developer-toolsclaude-code

Installation

# Add to your Claude Code skills
git clone https://github.com/mikeyobrien/ralph-orchestrator

README.md

Ralph Orchestrator

A 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

Installation

Via npm (Recommended)

npm install -g @ralph-orchestrator/ralph-cli

Via Homebrew (macOS)

brew install ralph-orchestrator

Via Cargo

cargo install ralph-cli

Quick Start

# 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 run -p "Add input validation to the /users endpoint"

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

# Option 1: nvm (recommended)
nvm install    # reads .nvmrc

# Option 2: direct install
# https://nodejs.org/

npm install          # install dependencies
npm run dev          # run both servers (backend:3000, frontend:5173)
npm run test:server  # backe...