evilayman/opencode-raven

Install

Raven 2.3 supports OpenCode V2 (2.0.26+). OpenCode V1 (1.18.29+) remains supported in the same package—no separate plugin is needed.

OpenCode V2

In OpenCode’s Install plugin feature, enter opencode-raven.

Or install globally from the CLI:

opencode plugin add opencode-raven

Either way, OpenCode manages the plugin configuration and automatically loads Raven’s terminal companion—no separate terminal plugin install is needed.

For manual configuration, use the v2 plugins key in opencode.jsonc instead:

{
  "plugins": ["opencode-raven"]
}

OpenCode V1

Use the v1 plugin key in opencode.jsonc:

{
  "plugin": ["opencode-raven"]
}

Restart OpenCode, then run /raven to verify the loaded version, model, routing, MCP health, and estimated savings. A fresh install may ask for one additional restart after selecting its model.

OpenCode resolves the package from npm and caches it automatically.

Upgrading From OpenCode 1 To 2

Keep using opencode-raven; change its OpenCode config entry from plugin to plugins. Raven’s existing ~/.config/opencode/opencode-raven/raven-config.json is shared by both versions, including models, on-demand MCPs, routing settings, and stats. Quit and restart OpenCode after upgrading.