opencode-ralph-loop

opencode-ralph-loop

Minimal Ralph Loop plugin for opencode - auto-continues until task completion.

Inspired by Anthropic's Ralph Wiggum technique for iterative, self-referential AI development loops.

Why this plugin?

oh-my-opencode is a fantastic, feature-rich plugin that includes Ralph Loop along with many other powerful capabilities like the Sisyphus orchestrator, background agents, and more.

However, we personally found the full suite a bit heavy for our workflow. We also noticed others in the community expressing interest in specific features without needing the complete package. So we extracted just the Ralph Loop functionality into this standalone, lightweight plugin.

If you want the full-featured experience, definitely check out oh-my-opencode. If you just want auto-continuation loops with minimal overhead, this plugin is for you.

Installation

Add to your ~/.config/opencode/opencode.json:

{
  "plugin": ["opencode-ralph-loop"]
}

Restart opencode. That's it!

Usage

Start a loop

/ralph-loop "Build a REST API with authentication"

The AI will work on your task and automatically continue until completion.

Cancel a loop

/cancel-ralph

How it works

• /ralph-loop creates a state file at .opencode/ralph-loop.local.md
• When the AI goes idle, the plugin checks if <promise>DONE</promise> was output
• If not found, it injects "Continue from where you left off"
• Loop continues until DONE is found or max iterations (100) reached
• State file is deleted when complete

Completion

When the AI finishes a task, it outputs:

<promise>DONE</promise>

This signals the loop to stop.

State File

The loop state is stored in your project directory:

.opencode/ralph-loop.local.md

Format (markdown with YAML frontmatter):

---
active: true
iteration: 3
maxIterations: 100
sessionId: ses_abc123
---

Your original task prompt

Add .opencode/ralph-loop.local.md to your .gitignore.

Features

• Minimal: ~150 lines, no bloat
• Project-relative: State file in .opencode/, not global
• Completion detection: Scans session messages for DONE promise
• Slash commands: /ralph-loop and /cancel-ralph
• Skills: AI can invoke the loop autonomously when appropriate

Credits

• Inspired by Anthropic's Ralph Wiggum plugin for Claude Code
• Implementation pattern from oh-my-opencode

License

MIT