aicoolies logo

ralphy

Multi-agent loop runner for autonomous PRD completion

Share
free
Visit Website →

ralphy is an autonomous bash-based orchestrator that runs Claude Code, Codex, OpenCode, Cursor agent, Qwen, and Droid in a continuous loop until a PRD is complete. Supports parallel task execution with isolated git worktrees, automated branching per task, PR creation, and webhook notifications to Discord and Slack. Cross-platform on macOS, Linux, and Windows via WSL2 or Git Bash.

Ralphy is an autonomous bash script that orchestrates multiple AI coding agents in a continuous loop until a product requirements document (PRD) is fully implemented. Named after Ralph Wiggum, it takes a deceptively simple approach to multi-agent development: write a PRD, run the script, and let it cycle through Claude Code, Codex, OpenCode, Cursor Agent, Qwen, Factory Droid, GitHub Copilot, and Gemini CLI until every requirement is satisfied. Each agent processes the same task or PRD section independently, with Ralphy managing the loop, checking completion criteria, and routing work between engines based on configurable preferences and availability.

The tool uses a file-based configuration system where developers define project settings including language, framework, test and lint commands, AI behavior rules, and file boundaries that agents must never modify. Rules persist across all tasks in a project, ensuring consistent coding standards regardless of which AI engine handles a particular iteration. Single-task mode handles quick changes like adding a login button with a one-liner command, while PRD mode processes multi-page requirement documents section by section. The bash-native implementation means zero dependencies beyond the AI CLIs themselves — no Node.js, no Python, no build step.

Licensed under MIT with over 2,500 GitHub stars, Ralphy addresses the practical reality that different AI coding agents excel at different types of tasks. Rather than committing to a single agent, it leverages the diversity of available coding assistants by running them in sequence until convergence. The project is actively maintained with Claude Code as the default engine and expanding support for newer entrants. Its simplicity is its strength — the entire orchestration logic lives in a single ralphy.sh file, making it trivial to audit, customize, and extend for specific team workflows without understanding complex framework abstractions.

Pricing

Free and open source, MIT licensed

Platforms

macOS, Linux, Windows (WSL2/Git Bash) — Node.js 18+

Categories

Tags

Use Cases

Alternatives

Related Tools

Claude Code logo

Claude Code

Top Pick

Anthropic's agentic coding CLI

Anthropic's agentic CLI coding tool that delegates complex tasks to Claude directly from the terminal. Understands entire codebases via automatic context gathering, edits multiple files, runs shell commands, and manages Git workflows autonomously. Supports CLAUDE.md for persistent project instructions, integrates with VS Code and JetBrains, and uses Claude Opus/Sonnet with extended thinking for complex architectural decisions. Built for terminal-first developers.

paidOpen Source
Cursor logo

Cursor

Top Pick

The AI-first code editor

AI-first code editor built as a VS Code fork that deeply integrates LLMs into every part of the development workflow. Features Tab autocomplete with multi-line predictions, Cmd+K inline editing, AI chat with full codebase awareness, and Agent mode for autonomous multi-file edits with terminal execution. Supports GPT-4, Claude, and more with automatic context from project files and docs. Includes privacy mode for SOC 2 compliance. The leading AI-native IDE with 100K+ paying users.

freemiumTelemetry
OpenCode logo

OpenCode

Top Pick

Open-source AI coding agent for the terminal

Open-source terminal-based AI coding agent built in Go by the SST team, with a rich TUI (Bubble Tea) supporting 75+ model providers including OpenAI, Anthropic, Gemini, Bedrock, Groq, and OpenRouter. Features vim-like editing, persistent SQLite sessions, and LSP integration for 40+ languages. Fully free with no vendor lock-in, it has rapidly grown to 95k+ GitHub stars.

open-source
Codex logo

Codex

Top Pick

OpenAI coding agent for app, editor, terminal, and cloud work

Codex is OpenAI's coding agent for software development across the Codex app, editor, terminal, and cloud tasks. It helps write, review, debug, refactor, and automate code, with ChatGPT plan access for managed surfaces and API-key usage for CLI, SDK, and IDE workflows. The open-source CLI and SDK support local repository work, while cloud features add GitHub review, Slack/Linear integrations, worktrees, skills, MCP, and automations.

freemiumOpen Source
Intercom MCP Server logo

Intercom MCP Server

Intercom's remote MCP server for support and Help Center context.

Intercom MCP Server is Intercom's hosted remote MCP server for connecting AI tools to Intercom workspace data. It supports the recommended Streamable HTTP endpoint, OAuth or bearer-token authentication, and tools for conversations, contacts, companies, and Help Center article workflows, with access limited by token permissions and Intercom workspace policy.

freemiumTelemetry
HubSpot MCP Server logo

HubSpot MCP Server

HubSpot's hosted MCP server for CRM data and workflows.

HubSpot MCP Server is HubSpot's hosted remote MCP server for connecting compatible AI tools to CRM data. It uses OAuth 2.1 with PKCE through MCP auth apps, then exposes HubSpot context such as contacts, companies, deals, tickets, activities, and marketing or content objects according to user permissions, granted scopes, and sensitive-data restrictions in the account.

freemiumTelemetry

Used in Stacks