Install for OpenCode

• OpenCode installed
• Bun runtime

1. Add the Weave adapter to your opencode.json or opencode.jsonc:

{
  "plugin": [
    "@weaveio/weave-adapter-opencode@1.0.0"
  ]
}

Use an exact version for reproducible installs. OpenCode resolves the package’s server export to the plugin entry point; do not point at dist/index.js or a source file.

2. Restart OpenCode after changing the plugin version.

3. Initialize Weave:

weave init --scope local --yes

See the CLI reference for more initialization options and the DSL Configuration guide for configuration syntax.

Verify the plugin loaded correctly:

opencode debug config

This shows the generated agent map. Also check plugin execution:

opencode debug info

You should see the Weave adapter listed in the plugin output.

Weave publishes to three npm channels:

• latest: Stable releases (recommended for production)
• next: Pre-release versions with upcoming features
• nightly: Bleeding-edge builds from the main branch

To use a release channel instead of an exact version, specify the channel tag:

{
  "plugin": [
    "@weaveio/weave-adapter-opencode@next"
  ]
}

Channel tags are mutable and will pull the latest version from that channel on each OpenCode restart.