Ralph Loop

A Ralph Wiggum Loop implementation that works™

[](https://www.npmjs.com/package/@pageai/ralph-loop)

📚 Full docs: [ralphloop.sh](https://ralphloop.sh)

Ralph is a long-running AI agent loop. Ralph automates software development tasks by iteratively working through a task list until completion. This allows for long running agent loops, effectively enabling AI to code for days at a time.

This is an implementation that actually works, containing a hackable script so you can configure it to your env and favorite agentic AI CLI. It's set up by default to use Claude Code in Docker Sandboxes, and supports [multiple Docker Sandboxes agents](#running-with-a-different-agentic-cli).

👉 [Watch the video](https://www.youtube.com/watch?v=3TL8Ez66I3o) for an in-depth walkthrough.

[](https://www.youtube.com/watch?v=3TL8Ez66I3o)

• Getting Started
  • (Optional) Set up code base
  • 1️⃣ Step 1: Install Ralph
  • 2️⃣ Step 2: Create a PRD + task list
  • 3️⃣ Step 3: Set up the agent inside Docker Sandboxes
  • 4️⃣ Step 4: Run Ralph
• Running the Ralph Loop with custom options
  • (Optional) Adjusting to your language/framework
• How It Works
• How Is This Different from Other Ralphs?
• Steering the Agent
• Support
  • Promise Tags
  • Exit Codes
• Structure
• Continued Development
• Skills
  • [Available Skills]