| name | agent-ralph-loop-claude |
| description | Implements the Ralph Wiggum technique as a Claude Code plugin for iterative, self-referential AI development loops. Use when building projects that require hands-free AI implementation through continuous bash-style loops inside a single Claude Code session, where the same prompt is repeatedly fed back until completion criteria are met. |
Ralph Loop Claude Plugin v1.0.0
Overview
Ralph Loop is a Claude Code plugin that implements the Ralph Wiggum technique — an iterative development methodology based on continuous AI agent loops. As Geoffrey Huntley describes it: "Ralph is a Bash loop" — a while true loop that repeatedly feeds an AI agent the same prompt, allowing it to iteratively improve its work until completion.
The plugin works entirely inside your current Claude Code session — no external bash loops needed. A Stop hook intercepts Claude's exit attempts and feeds the same prompt back, creating a self-referential feedback loop where Claude sees its own previous work in files and git history on each iteration.
When to Use
Good for:
- Well-defined tasks with clear success criteria
- Tasks requiring iteration and refinement (e.g., getting tests to pass)
- Greenfield projects where you can walk away
- Tasks with automatic verification (tests, linters, build checks)
Not good for:
- Tasks requiring human judgment or design decisions
- One-shot operations
- Tasks with unclear success criteria
- Production debugging (use targeted debugging instead)
Core Concepts
The Ralph Loop Mechanism
The core loop works like this:
- You run
/ralph-loop with a task description once
- Claude works on the task, modifying files
- Claude tries to exit the session
