Skip to content

PortableRalph

An autonomous AI development loop that works in any repo.

  • 🚀 Quick Start

    Get up and running in under a minute with our one-liner installer.

    Installation

  • 📚 Write Plans

    Learn how to write effective plans that Ralph can execute autonomously.

    Writing Plans

  • 🔔 Notifications

    Get notified on Slack, Discord, Telegram, or custom integrations.

    Notifications

  • âš™ How It Works

    Deep dive into Ralph's architecture and execution model.

    How It Works

âš¡ One-Line Install

curl -fsSL https://raw.githubusercontent.com/aaron777collins/portableralph/master/install.sh | bash

Then run Ralph on any plan:

ralph ./my-feature.md

✨ The Magic

 Your Plan          Ralph Loop              Progress File
+-----------+      +--------------+         +--------------+
| feature   |      | 1. Read      |         | - [x] Done   |
|   .md     | ---> | 2. Pick task | <-----> | - [ ] Todo   |
|           |      | 3. Implement |         | - [ ] Todo   |
+-----------+      | 4. Commit    |         |              |
                   | 5. Repeat    |         | RALPH_DONE   |
                   +--------------+         +--------------+

You write a plan file describing what to build

Ralph breaks it into discrete, actionable tasks

Each iteration: pick task → implement → validate → commit

Loop exits when RALPH_DONE appears on its own line in progress file

✅ Requirements

  • Claude Code CLI

    Install and authenticate the Claude Code CLI

  • Bash Shell

    Available on macOS, Linux, and WSL

  • Git (optional)

    For automatic commits after each task

Get Started

View on GitHub