@weaveio/weave-adapter-opencode

The Weave adapter for OpenCode. It loads .weave/config.weave, materializes Weave agents into OpenCode, and exposes the adapter's OpenCode commands and runtime hooks.

Install

Add the package name to the plugin array in opencode.json or opencode.jsonc:

{
  "plugin": [
    "@weaveio/[email protected]"
  ]
}

The package name is the canonical OpenCode plugin spec. OpenCode resolves the package's server export to the plugin entry point. Use an exact version for reproducible installs. Replace it with latest or next when you want npm to resolve a channel tag.

There is no separate npm install step for the OpenCode plugin. OpenCode fetches the package at startup. Restart OpenCode after changing the plugin version.

Minimal use

The plugin entry is all OpenCode needs: with no .weave config, the builtin agents (Loom, Tapestry, Shuttle, Pattern, Thread, Spindle, Weft, Warp) load with their defaults. To customize them, scaffold and validate a project config with the CLI (weave init --harness opencode also writes the plugin entry):

bun add --global @weaveio/weave-cli@latest
weave init --scope local --yes --harness opencode
weave validate --project
opencode

The plugin maps normalized agents, prompts, model preferences, skills, and supported tool policy into OpenCode. It provides /weave:start and the /start-work compatibility alias. It does not claim provider acceleration: fast true remains unsupported on OpenCode because the plugin has no correlated response evidence for the same request.

Verify loading with OpenCode's diagnostics:

opencode debug config
opencode debug info

Local development

To run a local build of this adapter in OpenCode, point the plugin entry at dist/plugin.js with an absolute file:// URL, in place of the published package. See Dogfooding a local build for the build commands and the other harnesses.

Supported host versions

| Host | Support | | --- | --- | | OpenCode | No independent version floor is encoded. The package declares @opencode-ai/plugin and @opencode-ai/sdk ~1.15.9; use an OpenCode release compatible with those APIs. | | Bun | Required for repository development and local builds. |

Documentation

See the OpenCode adapter reference for behavior, commands, logging, and capability limits.

License

MIT