ralph-wiggum-mcp

Start a Ralph Wiggum iterative development loop.

Ralph is a development methodology based on continuous AI agent loops. The technique creates a self-referential feedback loop where the same prompt is fed back repeatedly, allowing the AI to iteratively improve its work until completion.

NEW FEATURES:

• Iteration history tracking with progress metrics

• Git integration for automatic change tracking

• External tool integration (tests, linters)

• Smart stagnation detection and warnings

• Pre-built templates for common tasks

Use ralph_list_templates to see available templates.

Process the next iteration of a Ralph loop with enhanced tracking.

After completing work on the current iteration, call this tool with your output and optional metadata to:

1. Check if completion promise was met

2. Track iteration history (files modified, commands run, errors)

3. Run external tools if configured

4. Analyze progress and detect stagnation

5. Create git commits if enabled

6. Either continue loop or stop

Enhanced features:

• Automatic progress analysis

• Stagnation warnings with suggestions

• External tool integration

• Git commit tracking

Cancel the active Ralph loop.

Stops the current Ralph loop and removes all state. Use this when you want to manually stop the loop before completion.

Get the current status of the Ralph loop with progress insights.

Shows:

• Whether a loop is active

• Current iteration number

• Max iterations setting

• Completion promise (if set)

• The current prompt being iterated on

• Iteration history summary (total time, files changed, tools used)

• Progress analysis (stagnation detection, repeated errors)

• Estimated iterations remaining

Get detailed iteration history report.

Shows a comprehensive history of all iterations including:

• Timestamp and duration

• Files modified

• Commands run

• Errors encountered

• Git commits

• External tools run with results

List all available Ralph loop templates.

Templates are pre-built prompts and configurations for common tasks:

• REST API development

• Test-driven development

• Refactoring

• Bug fixing

• Documentation

• Performance optimization

• Security hardening

• And more...

Each template includes suggested settings and external tools.

Get details of a specific template.

Returns the full template configuration including:

• Name and description

• Complete prompt text

• Suggested completion promise

• Suggested max iterations

• Suggested external tools

• Git integration settings

Get git status and diff summary.

Shows:

• Current branch and commit

• Modified, added, deleted, and untracked files

• Diff summary (files changed, insertions, deletions)

Create a git commit for the current iteration.

Use this to manually create a commit with a custom message. If auto_commit is enabled, commits are created automatically.

Get context from recent Ralph commits.

Shows recent Ralph iteration commits from git history, providing context about what was done in previous iterations.

Run external tool presets (test runners, linters, etc.).

Available presets:

• javascript-test: Run npm test

• javascript-lint: Run ESLint

• python-test: Run pytest

• python-lint: Run ruff

• rust-test: Run cargo test

• rust-lint: Run clippy

• go-test: Run go test

• build: Verify project builds

Use ralph_detect_tools to see which presets are available for your project.

Detect which tool presets are available for the current project.

Analyzes the project structure and suggests relevant tool presets (e.g., if package.json exists, suggests javascript-test and javascript-lint).

List all available external tool presets.

Shows all available tool presets with descriptions, regardless of whether they're applicable to the current project.