Files
headroom/.opencode/command/ralph.md

45 lines
1.2 KiB
Markdown

---
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`.