ralph-wiggum

ABConvert Plugins Marketplace

Official Claude Code plugin marketplace by ABConvert.

Installation

1. Add the marketplace

Using CLI:

claude plugin marketplace add ABConvert/abconvert-plugins-official

Using Claude Code directly:

/plugin marketplace add ABConvert/abconvert-plugins-official

2. Install plugins

Plugins can be installed in different scopes:

Scope	Description
user	Available in all your Claude Code sessions (default)
project	Only available in the current project

Using CLI:

# Install for user (default)
claude plugin install ralph-wiggum@abconvert-plugins

# Install for current project only
claude plugin install ralph-wiggum@abconvert-plugins --scope project

Using Claude Code directly:

# Install for user (default)
/plugin install ralph-wiggum@abconvert-plugins

# Install for current project only
/plugin install ralph-wiggum@abconvert-plugins --scope project

---

Available Plugins

Ralph Wiggum

An iterative development loop that runs Claude with the same prompt repeatedly until task completion. Based on the Ralph Wiggum technique pioneered by Geoffrey Huntley.

How it works:

1. You provide a prompt and completion criteria
2. Claude works on the task and attempts to exit
3. A stop hook feeds the same prompt back
4. Claude sees its previous work in files/git history
5. Loop continues until the task is genuinely complete

Best for:

• Well-defined tasks with clear success criteria
• Tasks requiring iteration and refinement
• Greenfield projects you can walk away from
• Tasks with automatic verification (tests, linters)

Not recommended for:

• Tasks requiring human judgment
• One-shot operations
• Unclear success criteria

Commands

Command	Description
/ralph-wiggum:help	Show help documentation
/ralph-wiggum:ralph-loop	Start a Ralph loop
/ralph-wiggum:cancel-ralph	Cancel an active loop

Usage Examples

# Basic loop with iteration limit
/ralph-wiggum:ralph-loop "Build a REST API for todos" --max-iterations 20

# Loop with completion promise
/ralph-wiggum:ralph-loop "Fix all TypeScript errors" --completion-promise "All tests passing"

# Combined options
/ralph-wiggum:ralph-loop "Refactor auth module" --max-iterations 50 --completion-promise "DONE"

# Cancel an active loop
/ralph-wiggum:cancel-ralph

Autonomous Mode (No Approval Prompts)

For fully autonomous loops where you don't want to approve each action, start Claude Code with the --dangerously-skip-permissions flag:

# Start Claude Code in autonomous mode
claude --dangerously-skip-permissions

# Then run your ralph loop
/ralph-wiggum:ralph-loop "Build a REST API" --completion-promise "DONE" --max-iterations 50

Use cases for autonomous mode:

• Overnight/background tasks you can walk away from
• Well-defined tasks with automatic verification (tests, linters)
• Greenfield projects with clear completion criteria

Warning: This skips all permission prompts. Only use in trusted environments with well-defined tasks and iteration limits.

Completion Promise

To exit the loop, Claude must output the exact promise text in XML tags:

<promise>YOUR_PROMISE_TEXT</promise>

The promise must be genuinely true - Claude cannot lie to escape the loop.

---

Uninstall

Using CLI:

# Remove a plugin
claude plugin uninstall ralph-wiggum@abconvert-plugins

# Remove the marketplace
claude plugin marketplace remove abconvert-plugins

Using Claude Code directly:

# Remove a plugin
/plugin uninstall ralph-wiggum@abconvert-plugins

# Remove the marketplace
/plugin marketplace remove abconvert-plugins

---

Bug Fixes

This version includes fixes from PR #12642 addressing issue #12170:

• Fixed multi-line bash command blocking by security check
• Fixed permission check bug with auto-execute syntax
• Added clearer completion promise instructions

---

Contributing

Issues and pull requests welcome at github.com/ABConvert/abconvert-plugins-official.

License

MIT

Credits

• Original Ralph Wiggum technique by Geoffrey Huntley
• Original plugin by Daisy Hollman at Anthropic
• Bug fixes from PR #12642