headroom/.opencode/command/ralph.md

description

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

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

3. Run Ralph loop

   If the user did not provide iteration bounds, use:

   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

   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.