| name | ralph-loop |
| description | Use when performing ralph wiggum style long-running development loops with pacing control. |
Ralph Wiggum - Long-Running Development Loops
Long-running iterative development loops with pacing control.
When to Use
- Complex tasks requiring multiple iterations
- Tasks with many discrete steps that build on each other
- Work that benefits from periodic reflection
Do NOT use for simple one-shot tasks or quick fixes.
Agent Tool
Call ralph_start to begin a loop on yourself:
ralph_start({
name: "loop-name",
taskContent: "# Task\n\n## Goals\n- Goal 1\n\n## Checklist\n- [ ] Item 1\n- [ ] Item 2",
maxIterations: 50, // Default: 50
itemsPerIteration: 3, // Optional: suggest N items per turn
reflectEvery: 10, // Optional: reflect every N iterations
useSubagents: true, // Optional: delegate each task to subagent
subagentAgent: "default" // Optional: subagent name (default: 'default')
})
Loop Behavior
- Task content is saved to
.ralph/<name>.md
- Each iteration: work on task, update file
- Call
ralph_done tool to proceed to next iteration
- When complete: output
<promise>COMPLETE</promise>
- Loop ends on completion or max iterations (default 50)
User Commands
/ralph start <name|path> - Start a new loop/ralph resume <name> - Resume loop/ralph stop - Pause loop (when agent idle)/ralph-stop - Stop active loop (idle only)/ralph status - Show loops/ralph list --archived - Show archived loops
