English Français العربية

Ralph Wiggum Loop

Official registry Productivity

Autonomous iterative AI development MCP server with spec-driven worker/reviewer SHIP/REVISE loops.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

MCPB package https://github.com/sheldonrobinson/ralph-wiggum-loop/releases/download/v1.1.0/ralph-wiggum-loop.sh.mcpb
Claude Code 
claude mcp add ralph-wiggum-loop -e 'RALPH_STATE_BASE=<RALPH_STATE_BASE>' -e 'RALPH_RECIPE_DIR=<RALPH_RECIPE_DIR>' -- sh --stdio
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ralph-wiggum-loop": {
            "command": "sh",
            "args": [
                "--stdio"
            ],
            "env": {
                "RALPH_STATE_BASE": "<RALPH_STATE_BASE>",
                "RALPH_RECIPE_DIR": "<RALPH_RECIPE_DIR>"
            }
        }
    }
}

Environment variables

  • RALPH_STATE_BASE Directory path where active Ralph Loop state and iteration history are stored
  • RALPH_RECIPE_DIR Directory path containing workflow recipe JSON files
MCPB package https://github.com/sheldonrobinson/ralph-wiggum-loop/releases/download/v1.1.0/ralph-wiggum-loop.pwsh.mcpb
Claude Code 
claude mcp add ralph-wiggum-loop -e 'RALPH_STATE_BASE=<RALPH_STATE_BASE>' -e 'RALPH_RECIPE_DIR=<RALPH_RECIPE_DIR>' -- pwsh -Stdio
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ralph-wiggum-loop": {
            "command": "pwsh",
            "args": [
                "-Stdio"
            ],
            "env": {
                "RALPH_STATE_BASE": "<RALPH_STATE_BASE>",
                "RALPH_RECIPE_DIR": "<RALPH_RECIPE_DIR>"
            }
        }
    }
}

Environment variables

  • RALPH_STATE_BASE Directory path where active Ralph Loop state and iteration history are stored
  • RALPH_RECIPE_DIR Directory path containing workflow recipe JSON files

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ralph-wiggum-loop
  2. Overview
  3. Install Skill (.agents/skills/)
  4. OS-Specific MCP Servers (mcp.json)
  5. Quick Start
  6. Documentation
  7. Repository
  8. License

ralph-wiggum-loop

Multi-model iterative development agent plugin — Ralph Loop with cross-model worker/reviewer architecture, spec-driven development skills, Stop hooks, and SHIP/REVISE decision engine.

Overview

The Ralph Loop implements a two-phase iterative workflow where a worker model does the work and a reviewer model provides cross-model review, iterating until the reviewer says "SHIP".

This project is a cross-platform Agent Plugin (plugin.json, mcp.json, .agents/skills/ralph-wiggum-loop/ & skills/ralph-wiggum-loop/) with native implementations for:

  • Linux / macOS (Bash): bin/ralph-wiggum-loop.sh (using bin/mcp-sdk.sh)
  • Windows (PowerShell): bin/ralph-wiggum-loop.ps1 (using bin/mcp-sdk.psm1)
  • Polyglot Runner: bin/script-runner.sh / bin/script-runner.ps1 (runs in both POSIX sh/bash and PowerShell)

Install Skill (.agents/skills/)

Per the Agent Skills Specification, install the skill to .agents/skills/:

# Project-level (.agents/skills/ralph-wiggum-loop) or User-level (~/.agents/skills/ralph-wiggum-loop)
mkdir -p .agents/skills
cp -R skills/ralph-wiggum-loop .agents/skills/ralph-wiggum-loop
New-Item -ItemType Directory -Path .agents/skills -Force | Out-Null
Copy-Item -Recurse -Force skills/ralph-wiggum-loop .agents/skills/ralph-wiggum-loop

OS-Specific MCP Servers (mcp.json)

MCP Server NameOS / RuntimeTransportCommand / Endpoint
ralph-wiggum-loopLinux / macOS (Bash)stdio./bin/script-runner.sh ralph-wiggum-loop --stdio
ralph-wiggum-loop-pwshWindows (PowerShell 7+)stdiopwsh -NoProfile -ExecutionPolicy Bypass -File ${PLUGIN_ROOT}/bin/script-runner.ps1 ralph-wiggum-loop --stdio
ralph-wiggum-loop-powershellWindows (PowerShell 5.1)stdiopowershell.exe -NoProfile -ExecutionPolicy Bypass -File ${PLUGIN_ROOT}/bin/script-runner.ps1 ralph-wiggum-loop --stdio
ralph-wiggum-loop-httpCross-Platformstreamable-httphttp://127.0.0.1:8080/mcp

Quick Start

1. CLI Mode
  • Linux / macOS (Bash):
    ./bin/ralph-wiggum-loop.sh "Implement user authentication with JWT tokens" --profile pro
  • Windows (PowerShell):
    pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\ralph-wiggum-loop.ps1 "Implement user authentication with JWT tokens" --profile pro
2. MCP Server (stdio Mode)
  • Linux / macOS (Bash):
    ./bin/ralph-wiggum-loop.sh --stdio
  • Windows (PowerShell):
    pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\ralph-wiggum-loop.ps1 --stdio
3. MCP Server (streamable-http Service Mode)
  • Linux / macOS (Bash):
    ./bin/script-runner.sh start-http-server start --host 127.0.0.1 --port 8080
  • Windows (PowerShell):
    pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\script-runner.ps1 start-http-server start --host 127.0.0.1 --port 8080

Documentation

Repository

License

MIT

Frequently asked questions

What is Ralph Wiggum Loop?

Autonomous iterative AI development MCP server with spec-driven worker/reviewer SHIP/REVISE loops.

How do I install Ralph Wiggum Loop?

It runs on your machine. In Claude Code: claude mcp add ralph-wiggum-loop -e 'RALPH_STATE_BASE=<RALPH_STATE_BASE>' -e 'RALPH_RECIPE_DIR=<RALPH_RECIPE_DIR>' -- sh --stdio. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Ralph Wiggum Loop need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Ralph Wiggum Loop open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Ralph Wiggum Loop?

It is published by sheldonrobinson. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.