Ender Wiggin Help

Explain the Ender Wiggin task completion loop to the user:

Overview

Ender Wiggin is a task completion loop plugin. Like ralph-wiggum, but for tasks that are designed to end.

Use it when you have a task that:

• Is designed to complete successfully
• Can be run again from zero context
• Should eventually end (has a completion condition)

The Key Question

When you finish an iteration and try to exit, the checkpoint asks:

If context were cleared right now and this exact command given to a fresh instance, would it pick up wherever appropriate?

This ensures you wrap up properly before context resets.

How It Works

1. Start Loop: /ender-loop /my-task --max-iterations 10
2. Execute: Runs your command
3. Finish: When you try to exit, stop hook intercepts
4. Checkpoint: Wrap up - persist state, complete in-flight work
5. Repeat: Context resets, command runs again from persisted state

vs Ralph Wiggum

Ralph Wiggum	Ender Wiggin
General-purpose loops	Task completion loops
Runs forever by default	Designed to end
Same prompt each iteration	Checkpoint + command
For exploration/iteration	For tasks that should complete

Available Commands

• /ender-loop COMMAND [OPTIONS] - Start task completion loop

  • --max-iterations N - Stop after N iterations (default: unlimited)
  • --completion-promise 'TEXT' - Stop when this promise can be truthfully output
  • --checkpoint-prompt 'TEXT' - Custom checkpoint instructions

• /cancel-ender - Cancel an active loop

• /ender-help - Show this help

Examples

# Development workflow
/ender-loop /work feature-x --max-iterations 10
/ender-loop /work --completion-promise 'All tests passing'

# Data processing
/ender-loop /process-batch --completion-promise 'Queue is empty'

# Review tasks
/ender-loop /review-prs --max-iterations 5

# Any repeatable task
/ender-loop 'Process next item' --completion-promise 'No items remaining'

# Custom checkpoint
/ender-loop /migrate --checkpoint-prompt 'Verify state saved to database'

Completion Promises

To exit a loop with a completion promise, output:

<promise>Your exact promise text here</promise>

The promise must be completely and unequivocally TRUE. Do not lie to exit the loop.

Custom Checkpoints

The default checkpoint helps you wrap up for a fresh instance. Customize for specific workflows:

# Database state
--checkpoint-prompt 'Verify checkpoint saved to migrations table'

# File-based state
--checkpoint-prompt 'Confirm processed files moved to /completed'

# External API state
--checkpoint-prompt 'Ensure sync cursor persisted to state.json'

Monitoring

# Check current iteration
grep '^iteration:' .claude/ender-loop.local.md

# View full state
cat .claude/ender-loop.local.md

State Persistence

Your work persists through whatever mechanism your task uses:

• Files on disk
• Database records
• External APIs
• Git commits
• Any external state

This is why Ender works - each iteration can see prior work through persistent state, even with fresh context.