Ralph Cmd

Output the shell command to run the Ralph orchestrator.

eltanno updated 4mo ago
Claude CodeGeneric
View source ↗
# Ralph Command - Output the command to start Ralph loop

**Output the shell command to run the Ralph orchestrator.**

## Purpose

This command outputs the exact shell command you should run **outside of Claude** to start the Ralph PRD implementation loop. The orchestrator runs in your terminal and only invokes Claude when LLM intelligence is needed.

## Action

Find the most recent approved PRD and its corresponding plan, then output the command.

### Step 1: Find PRD and Plan

```bash
# Find most recent approved PRD
ls -t docs/prds/*.md 2>/dev/null | head -5

# Check for corresponding plan
ls -t docs/plans/*.md 2>/dev/null | head -5

Step 2: Output Command

If arguments provided, use those. Otherwise, identify the PRD/Plan from the files above.

Output format:

══════════════════════════════════════════════════════════════
  RALPH ORCHESTRATOR COMMAND
══════════════════════════════════════════════════════════════

Run this command in your terminal (NOT inside Claude):

  .claude/ralph/ralph run <prd-path> <plan-path>

Example with detected files:

  .claude/ralph/ralph run docs/prds/YYYY-MM-DD-feature.md docs/plans/YYYY-MM-DD-feature.md

Options:
  --dry-run         Preview without invoking Claude
  --max-attempts N  Max retries per ticket (default: 3)
  --verbose         Show debug output and stack traces

══════════════════════════════════════════════════════════════

Copy and paste the command above into a NEW terminal window.
Do NOT run it inside this Claude session.

Prerequisites

  • Python 3.10 or higher
  • gh CLI (authenticated)
  • git CLI

Why Outside Claude?

Running the orchestrator outside Claude means:

  • Zero LLM cost for mechanical work (state, validation, git, PRs)
  • Claude only invoked for implementation and fixing failures
  • ~80% fewer API calls compared to running everything through Claude

Arguments

$ARGUMENTS

If a PRD path is provided, use it. Otherwise, detect from docs/prds/. ```

Maintain Ralph Cmd?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[Ralph Cmd on getagentictools](https://getagentictools.com/loops/eltanno-ralph-command-output-the-command-to-start-ralph-loop?ref=badge)