Ralph - Autonomous Loop Setup

Ralph is an external bash loop that runs Claude with fresh context for each task. Named after Ralph Wiggum from The Simpsons.

Core Principle

"One bash loop. Static prompt. Clean task list. Fresh start every iteration."

The loop MUST be external to Claude. Each iteration MUST be a fresh Claude process.

Claude Code Tasks Integration (NEW)

Ralph now integrates with Claude Code's native Tasks feature:

• CLAUDE_CODE_TASK_LIST_ID - Shared across iterations for coordination
• Task tools enabled - TaskCreate, TaskUpdate, TaskList, TaskGet
• Hybrid approach - Uses both .ralph/task.md (validation) and native Tasks (coordination)

See TASKS.md for full documentation.