evilayman/opencode-raven

OpenCode-Raven 将嘈杂的工具工作排除在你的主OpenCode环境中。 支持OpenCode V2（2.0.26+）和OpenCode V1（1.18.29+），合集于一体。

为什么是Raven Raven将搜索和按需MCP检索委派给不同的专注代理，然后将简洁证据返回调用会话。

通过raven_seek路由OpenCode搜索工具和全局配置的MCP。 通过raven_mcp 使用可单独配置的模型进行按需 MCP 检索。 将可选的按需MCP模式排除在主模型工具列表中。 预配置 Context7、Exa 和 Grep.app 端点。 追踪通过委派避免的估计主会话上下文。

安装

Raven 2.3 支持 OpenCode V2 （2.0.26+）。 OpenCode V1 （1.18.29+） 在同一包中依然支持——无需单独插件。

开放代码 V2

在opencode.jsonc中使用v2 plugins键：

开放代码 V1

在 opencode.jsonc 中使用 v1 plugin 键：

重启 OpenCode，然后运行 /raven 以验证已加载的版本、型号、路由、MCP 健康状况及预计节省。新安装时，选择模型后可能会要求额外重启一次。

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.