Compatibility
OpenCode
Section titled “OpenCode”The supported runtime is OpenCode 1.17.18. Other versions work only while they retain the v1 TUI command bridge used by the plugin.
The server hook and TUI entry must load the same package version. Pin both configuration files instead of using an unversioned npm spec.
Node.js
Section titled “Node.js”These lines are declared in the package engines metadata:
- Node.js
^22.22.2 - Node.js
^24.15.0 - Node.js
>=26.0.0
CI runs Node 22, 24, and 26 on Linux, plus Node 24 on Windows. Other versions are not tested.
Package format
Section titled “Package format”The npm package publishes TypeScript source because OpenCode loads plugin entries directly. The package has no runtime dependency on @opencode-ai/plugin; its imports are type-only.
Upgrading
Section titled “Upgrading”- Read the changelog.
- Change the version in both plugin configuration files.
- Close every OpenCode process.
- Restart and verify both commands in the palette.