Repository avatar
AI Tools
v1.1.0
active

ralph-wiggum-loop

io.github.sheldonrobinson/ralph-wiggum-loop

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

Documentation

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.

License: MIT Agent Plugin GitHub Pages

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

Ralph Wiggum Loop MCP server

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

MCPB
https://github.com/sheldonrobinson/ralph-wiggum-loop/releases/download/v1.1.0/ralph-wiggum-loop.sh.mcpb
Install Command
# mcpb: https://github.com/sheldonrobinson/ralph-wiggum-loop/releases/download/v1.1.0/ralph-wiggum-loop.sh.mcpb
Runtime: sh
MCPB
https://github.com/sheldonrobinson/ralph-wiggum-loop/releases/download/v1.1.0/ralph-wiggum-loop.pwsh.mcpb
Install Command
# mcpb: https://github.com/sheldonrobinson/ralph-wiggum-loop/releases/download/v1.1.0/ralph-wiggum-loop.pwsh.mcpb
Runtime: pwsh