Ralph Loop Mechanics

How It Works

1. Start: User runs

   /majestic-ralph:start "<prompt>" --max-iterations N --completion-promise "WORD"

2. Loop: Stop hook intercepts session exit, re-feeds same prompt
3. Exit: Output

   <promise>WORD</promise>

   to signal genuine completion

State File

.claude/ralph-loop.local.yml

iteration: 1
max_iterations: 50
completion_promise: DONE
started_at: 2024-01-15T10:30:00Z
prompt: |
  Your prompt here.
  Can be multiline.

Completion Signal

<promise>YOUR_PHRASE</promise>

• Only output when genuinely complete
• Lying restarts the loop
• Max iterations is a hard stop

Safety Rules

IF NOT EXISTS

-i

Monitoring

# Check iteration
grep '^iteration:' .claude/ralph-loop.local.yml

# Cancel loop
/majestic-ralph:cancel