The Ralph Wiggum

✨Key Features

• ▸Iterative Loop Mechanism: Uses a Stop hook to block Claude's session exit, automatically re-issuing the original prompt with updated context (file changes, git history) for continuous refinement.
• ▸Self-Referential Improvement: Claude reviews its own previous work in each iteration, turning failures into data for better results—ideal for test-driven development (TDD) and multi-pass refinements.
• ▸Usage Commands: Start with /ralph-loop "task description" --completion-promise "DONE" --max-iterations 50; cancel with /cancel-ralph.
• ▸Clear Completion Criteria: Loop ends when Claude outputs an exact predefined promise string (e.g., "COMPLETE") or max iterations is reached, preventing infinite loops.
• ▸Best For: Well-defined tasks like building features with tests, refactoring codebases, or handling edge cases through repeated cycles; not suited for open-ended design or one-shot work.
• ▸Philosophy: "Ralph is a Bash loop"—simple, relentless automation where iteration trumps perfection; inspired by external techniques for agentic persistence.
• ▸Integration: Install via Claude Code plugin marketplace; runs entirely within a single session, no external scripting needed.
• ▸Safety & Control: Configurable iteration limits; human oversight via clear prompts and cancellable loops.
• ▸Real-World Applications: Generates complete repos, passes all tests autonomously, or builds complex systems (e.g., APIs, e-commerce phases) over many cycles.