---
description: Run Open Ralph Wiggum loops in this repository
---

Run Open Ralph Wiggum in the current repository with OpenCode as the default agent.

**Input**: The argument after `/ralph` is the Ralph task prompt. Optional Ralph flags may be included.

**Steps**

1. **Require task input**

   If no argument is provided, ask:
   > "What task should Ralph run? Include success criteria and completion promise if you have one."

   Stop after asking.

2. **Install Ralph locally in `.opencode`**

   ```bash
   npm install --prefix ".opencode" @th0rgal/ralph-wiggum
   ```

3. **Run Ralph loop**

   If the user did not provide iteration bounds, use:
   ```bash
   npx --prefix ".opencode" ralph "<input>" --agent opencode --max-iterations 10
   ```

   If the user included explicit flags (for example `--max-iterations`, `--tasks`, `--model`), preserve them and append `--agent opencode` only when agent is not specified.

4. **After run, show control commands**

   ```bash
   npx --prefix ".opencode" ralph --status
   npx --prefix ".opencode" ralph --add-context "Focus on <area>"
   ```

**Guardrails**

- Do not add `open-ralph-wiggum` to OpenCode plugin config.
- Keep the run scoped to this repository.
- Prefer bounded loops with `--max-iterations`.
