Ralph Wiggum Plugin for Windows
A Windows-compatible Claude Code plugin implementing the Ralph Wiggum technique - iterative, self-referential AI development loops using PowerShell.
"Me fail English? That's unpossible!" - Ralph Wiggum
What is the Ralph Wiggum Technique?
The Ralph Wiggum technique, pioneered by Geoffrey Huntley, is an iterative development methodology based on continuous AI loops:
while ($true) {
Get-Content PROMPT.md | claude --continue
}
Core concept: The same prompt is fed to Claude repeatedly. Claude sees its own previous work in files and git history, allowing it to iteratively improve until the task is complete.
How It Works
- You start a Ralph loop with a task prompt
- Claude works on the task, modifying files
- When Claude tries to exit, the stop hook intercepts
- The same prompt is fed back to Claude
- Claude sees its previous work and continues improving
- Loop continues until completion criteria are met
Installation
Option 1: Project-Level Installation (Recommended)
Install Ralph Wiggum for a specific project only:
# Navigate to your project directory
cd C:\path\to\your\project
# Download and run installer
irm https://raw.githubusercontent.com/Arthur742Ramos/ralph-wiggum-windows/main/install.ps1 | iex
Or if you've already cloned the repository:
# Run installer from cloned repo
powershell -ExecutionPolicy Bypass -File path\to\ralph-wiggum-windows\install.ps1
The installer will automatically:
- Clone the repository (if needed)
- Create required directories in
.claude/plugins/
- Copy all files to the correct locations
- Verify the installation
- Clean up temporary files
Use -KeepSource flag to keep the source repository after installation.
Option 2: Global Installation
Install globally for all projects:
# Clone directly to Claude Code plugins folder
git clone https://github.com/Arthur742Ramos/ralph-wiggum-windows ~/.claude/plugins/ralph-wiggum-windows
Option 3: Manual Installation
- Download or clone this repository
- Copy the entire folder to
~/.claude/plugins/ralph-wiggum-windows (global) or .claude/plugins/ralph-wiggum-windows (project-level)
- Restart Claude Code
Verify Installation
After installation, validate the plugin and restart Claude Code:
# For project-level installation
claude plugin validate .claude/plugins/ralph-wiggum-windows
# For global installation
claude plugin validate ~/.claude/plugins/ralph-wiggum-windows
You should see these commands available in Claude Code:
/ralph-wiggum-windows:ralph-loop - Start a Ralph loop/ralph-wiggum-windows:cancel-ralph - Cancel active loop/ralph-wiggum-windows:help - Show general help/ralph-wiggum-windows:help-ralph - Show detailed Ralph Wiggum technique guide
Quick Start
/ralph-wiggum-windows:ralph-loop "Build a REST API for todos with CRUD operations, validation, and tests" --completion-promise "API COMPLETE" --max-iterations 30
Commands
/ralph-wiggum-windows:ralph-loop
Start a Ralph loop in your current session.
Usage:
/ralph-wiggum-windows:ralph-loop "<prompt>" [--max-iterations N] [--completion-promise "<text>"]
Options:
| Option | Description | Default |
|---|
--max-iterations <n> | Maximum iterations before auto-stop | unlimited |
--completion-promise <text> | Phrase that signals successful completion | none |
Examples:
# Run until "DONE" is achieved, max 50 iterations
/ralph-wiggum-windows:ralph-loop "Refactor the cache layer for better performance" --completion-promise "DONE" --max-iterations 50
# Run for exactly 10 iterations
/ralph-wiggum-windows:ralph-loop "Explore optimization opportunities" --max-iterations 10
# Run indefinitely (use with caution!)
/ralph-wiggum-windows:ralph-loop "Continuously improve test coverage"
/ralph-wiggum-windows:cancel-ralph
Cancel an active Ralph loop immediately.
/ralph-wiggum-windows:cancel-ralph
/ralph-wiggum-windows:help
Display comprehensive help about the Ralph Wiggum technique and all available commands.
/ralph-wiggum-windows:help
Completion Promises
To signal that a task is complete, Claude must output a <promise> tag:
<promise>TASK COMPLETE</promise>
