English Français العربية

Ralph Wiggum Loop

السجل الرسمي الإنتاجية

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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>"
            }
        }
    }
}

متغيرات البيئة

  • 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 (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>"
            }
        }
    }
}

متغيرات البيئة

  • 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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو Ralph Wiggum Loop؟

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

كيف أثبّت Ralph Wiggum Loop؟

يعمل على جهازك. في 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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Ralph Wiggum Loop إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Ralph Wiggum Loop مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Ralph Wiggum Loop؟

ينشره sheldonrobinson. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.