---
name: open-ralph-wiggum
description: Run autonomous Ralph loops in the current repository using OpenCode as the default agent.
license: MIT
compatibility: Requires Node.js/npm and OpenCode CLI configured with a working model.
metadata:
  author: th0rgal
  source: https://github.com/Th0rgal/open-ralph-wiggum
---

Use Open Ralph Wiggum to run repeatable autonomous coding loops from OpenCode.

**Input**: The user message after this skill should include the task prompt for Ralph. Optional Ralph flags can be passed as part of the message.

**Steps**

1. **Validate a task prompt exists**

   If no task prompt is provided, ask for one clear prompt and stop.

2. **Ensure Ralph CLI is available in this repo**

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

3. **Run Ralph with OpenCode agent (default)**

   Use local binary via `npx` so no global install is required:
   ```bash
   npx --prefix ".opencode" ralph "<user prompt>" --agent opencode --max-iterations 10
   ```

   If the user already included `--max-iterations`, keep their value.

4. **Report result and next controls**

   Mention how to monitor or steer loop if still running:
   - `npx --prefix ".opencode" ralph --status`
   - `npx --prefix ".opencode" ralph --add-context "<hint>"`

**Guardrails**

- Do not register Ralph as an OpenCode plugin. It is a CLI wrapper, not a plugin.
- Keep execution in the current repository.
- Do not use unlimited iterations by default; always set `--max-iterations` unless user explicitly asks otherwise.