[GH-ISSUE #75] version 2.0.10 not allowing use of opencode #30

New issue

Closed

opened 2026-02-27 10:21:51 +03:00 by kerem · 2 comments

kerem commented

2026-02-27 10:21:51 +03:00

Owner

Originally created by @mrhut10 on GitHub (Jan 19, 2026).
Original GitHub issue: https://github.com/mikeyobrien/ralph-orchestrator/issues/75

when I run ralph init --backend opencode i'm getting the following error

Unknown backend 'opencode' see screenshot below

Originally created by @mrhut10 on GitHub (Jan 19, 2026). Original GitHub issue: https://github.com/mikeyobrien/ralph-orchestrator/issues/75 when I run `ralph init --backend opencode` i'm getting the following error Unknown backend 'opencode' see screenshot below <img width="1814" height="278" alt="Image" src="https://github.com/user-attachments/assets/256ff033-328d-4222-a490-d526be7e0684" />

kerem closed this issue

2026-02-27 10:21:51 +03:00

kerem commented

2026-02-27 10:21:51 +03:00

Author

Owner

@mikeyobrien commented on GitHub (Jan 19, 2026):

You can use this, the adapter was implemented but the validation and handling of ralph init was missed:

# Event loop settings
event_loop:
  completion_promise: "LOOP_COMPLETE"
  max_iterations: 100
  max_runtime_seconds: 14400           # 4 hours
  idle_timeout_secs: 1800

# CLI backend settings
cli:
  backend: "opencode"
  prompt_mode: "arg"                   # Positional argument after `run` subcommand

# Core behaviors (always injected into prompts)
core:
  scratchpad: ".agent/scratchpad.md"
  specs_dir: "./specs/"
  guardrails:
    - "Fresh context each iteration - scratchpad is memory"
    - "Don't assume 'not implemented' - search first"
    - "Backpressure is law - tests/typecheck/lint must pass"

If that doesn't work, this stopgap should work in the meantime.

  # ralph.yml - OpenCode via custom backend
  cli:
    backend: "custom"
    command: "opencode"
    args: ["run"]
    prompt_mode: "arg"

  event_loop:
    prompt_file: "PROMPT.md"
    completion_promise: "LOOP_COMPLETE"
    max_iterations: 100

@mikeyobrien commented on GitHub (Jan 19, 2026): You can use this, the adapter was implemented but the validation and handling of `ralph init` was missed: ``` # Event loop settings event_loop: completion_promise: "LOOP_COMPLETE" max_iterations: 100 max_runtime_seconds: 14400 # 4 hours idle_timeout_secs: 1800 # CLI backend settings cli: backend: "opencode" prompt_mode: "arg" # Positional argument after `run` subcommand # Core behaviors (always injected into prompts) core: scratchpad: ".agent/scratchpad.md" specs_dir: "./specs/" guardrails: - "Fresh context each iteration - scratchpad is memory" - "Don't assume 'not implemented' - search first" - "Backpressure is law - tests/typecheck/lint must pass" ``` If that doesn't work, this stopgap should work in the meantime. ``` # ralph.yml - OpenCode via custom backend cli: backend: "custom" command: "opencode" args: ["run"] prompt_mode: "arg" event_loop: prompt_file: "PROMPT.md" completion_promise: "LOOP_COMPLETE" max_iterations: 100 ```

kerem commented

2026-02-27 10:21:51 +03:00

Author

Owner

@mikeyobrien commented on GitHub (Jan 20, 2026):

Fixed in v2.1.0! 🎉

# Update to v2.1.0
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.1.0/ralph-installer.sh | sh

# Now works
ralph init --backend opencode

@mikeyobrien commented on GitHub (Jan 20, 2026): Fixed in v2.1.0\! 🎉 ```bash # Update to v2.1.0 curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.1.0/ralph-installer.sh | sh # Now works ralph init --backend opencode ```

kerem referenced this issue

2026-02-27 10:22:13 +03:00

[PR #30] [MERGED] Prepare PyPI release: fix packaging and Windows compatibility #100