Ralph Orchestrator is a Rust-based framework implementing autonomous AI agent orchestration with multi-backend support and a hat-based coordination system. It emphasizes iterative task completion and human-in-the-loop options, with a web dashboard and MCP server capabilities.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Ralph Orchestrator is a hat-based orchestration framework that implements the Ralph Wiggum technique — autonomous task completion through continuous iteration. It supports:
- Multi-Backend Support — Claude Code, Kiro, Gemini CLI, Codex, Forge, Amp, Copilot CLI, OpenCode
- Hat System — Specialized personas coordinating through events
- Backpressure — Gates that reject incomplete work (tests, lint, typecheck)
- Memories & Tasks — Persistent learning and runtime work tracking
- 5 Supported Builtins —
code-assist,debug,research,review, andpdd-to-code-assist, with more patterns documented as examples
How it works
The project implements an orchestration loop where agents operate under hats, coordinating via events, with gates to prevent progression on incomplete tasks. It includes a web dashboard for monitoring and a human-in-the-loop component (RObot) via Telegram, enabling interactive guidance and blocking behavior until responses are received.
Getting started
Installation options:
- Via npm (Recommended):
npm install -g @ralph-orchestrator/ralph-cli - Via GitHub Releases installer:
curl --proto '=https' --tlsv1.2 -LsSf \ https://github.com/mikeyobrien/ralph-orchestrator/releases/latest/download/ralph-cli-installer.sh | sh - 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: .ralph/specs/user-authentication/requirements.md, design.md, implementation-plan.md
# 3. Implement the feature
ralph run -p "Implement the feature in .ralph/specs/user-authentication/"
Ralph iterates until it outputs LOOP_COMPLETE or hits the iteration limit.
Web Dashboard commands:
ralph web
ralph web --no-open
ralph web --backend-port 4000
ralph web --frontend-port 8080
ralph web --legacy-node-api
MCP Server:
ralph mcp serve --workspace-root /path/to/repo
Recent releases
Latest releases include:
- v2.10.1 (2026-06-22) with fixes for e2e mock-mode verification and cassette-backed backend prompts over stdin
- v2.10.0 (2026-06-21) adding Forge CLI backend integration, RObot RPC domain, and a file-backed web mode
- v2.9.3 (2026-05-08) ralph-bench notes
Install instructions for prebuilt binaries are shown in the latest release notes, including a curl command to fetch the installer.
Traction
Stars: 3090 | Forks: 287 | Open issues: 7
Behind the repo
Not provided in the README excerpt.
Caveats
License: MIT. System requirements include Rust toolchain and Node.js for the frontend. Homebrew is not currently published from this repository's automated release flow.
Additional notes:
- Documentation and Quick Start emphasize backend backends (Claude Code, Kiro, Gemini CLI, Codex, Forge, Amp, Copilot CLI, OpenCode)
- Web dashboard is Alpha
- RObot Telegram integration details and YAML example are included