mikeyobrien

Ralph Orchestrator — Data & AI agent for Claude Code

Data & AI community intermediate

by mikeyobrien - Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the.

How to install Ralph Orchestrator

This entry records only its repository, not the path inside it, so there is no exact command to give. Open mikeyobrien/ralph-orchestrator and copy the folder into ~/.claude/agents/.

What Ralph Orchestrator does

[](LICENSE) [](https://www.rust-lang.org/) [](https://github.com/mikeyobrien/ralph-orchestrator/actions) [](coverage/index.html) [](https://github.com/hesreallyhim/awesome-claude-code) [](https://mikeyobrien.github.io/ralph-orchestrator/)

Alternatives in Data & AI

Credential Hunter — Autonomous credential-attack pipeline runner 4.5k ★
Taskade — AI-powered workspace with autonomous agents, real-time collaboration, and workflow automation with MCP integra 116 ★
Triage TS — LLM instruction for the TypeScript orchestrator triage role 93 ★

README

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](https://mikeyobrien.github.io/ralph-orchestrator/)** | **[Getting Started](https://mikeyobrien.github.io/ralph-orchestrator/getting-started/quick-start/)** | **[Presets](https://mikeyobrien.github.io/ralph-orchestrator/guide/presets/)**

Installation

Via npm (Recommended)

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

Via Homebrew (macOS/Linux)

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/"

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"

Web Dashboard (Alpha)

**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 Rust RPC API + frontend + opens browser
ralph web --no-open                    # skip browser auto-open
ralph web --backend-port 4000          # custom RPC API port

...