Skip to main content
Glama

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)

Related MCP server: vibe-gate-mcp

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 Name

OS / Runtime

Transport

Command / Endpoint

ralph-wiggum-loop

Linux / macOS (Bash)

stdio

./bin/script-runner.sh ralph-wiggum-loop --stdio

ralph-wiggum-loop-pwsh

Windows (PowerShell 7+)

stdio

pwsh -NoProfile -ExecutionPolicy Bypass -File ${PLUGIN_ROOT}/bin/script-runner.ps1 ralph-wiggum-loop --stdio

ralph-wiggum-loop-powershell

Windows (PowerShell 5.1)

stdio

powershell.exe -NoProfile -ExecutionPolicy Bypass -File ${PLUGIN_ROOT}/bin/script-runner.ps1 ralph-wiggum-loop --stdio

ralph-wiggum-loop-http

Cross-Platform

streamable-http

http://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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables an autonomous build loop where Jev makes typed routing and completion decisions while Claude Code writes code, runs checks, and requires independent review before declaring tasks done.
    4
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables Codex and Claude Code to collaborate autonomously as persistent peers that research, exchange questions and challenges, jointly edit a shared versioned report or coding repository, and record disagreements and evidence. A deterministic coordinator enforces the lifecycle and a dual approval gate on an exact artifact version before exporting an immutable final result.
    1
    MIT