Skip to content

Supported hosts and versions ​

Version scope: stable 0.1.x, current package 0.1.1.

OpenCode hosts ​

OpenCode CLI@opencode/plugin API
2.2.62.2.6
2.2.72.2.7
2.3.02.3.0

Peer dependency range: 2.2.6 || 2.2.7 || 2.3.0.

Only releases exercised by the compatibility matrix belong in this set. A new host needs a fresh probe and an explicit set change; the docs do not widen to a floating range.

Node ​

  • Minimum supported Node: Node 22.23.4 or newer
  • Package engines.node: >=22.23.4
  • Tested matrix: Node 22.23.4, Node 24.22.1, Node 26.12.1
  • Live and pull-request CI: Node 26.12.1
  • Failure mode below the floor: a load-time NodeVersionError with code unsupported_node.

Contract constants ​

ConstantValueMeaning
ENSEMBLE_BLOCK_VERSION7Generated AGENTS.md roster contract (contract v7).
ENSEMBLE_PROTOCOL_VERSION4Service RPC protocol version.
SHARED_SERVICE_VERSION3Process-global shared registry contract.
BACKUP_FORMAT_VERSION1Recovery backup document version.
package version0.1.1Published package version used by install instructions.

Unsupported-host behavior ​

An unknown or missing host version stays quiet. A known but untested version loads with this warning. The example below uses 2.4.0; the text substitutes the observed version:

OpenCode 2.4.0 is not supported by this Ensemble build; supported hosts are 2.2.6, 2.2.7, and 2.3.0 (@opencode/plugin 2.2.6 || 2.2.7 || 2.3.0). Ensemble will continue, but behavior on this version is untested.

Ensemble continues after the warning, but behavior on that host is untested. Runtime compatibility is not the same as the installed @opencode/plugin type-package version.

Platform boundary ​

  • Linux with tmux is the primary verified platform. macOS/Herdr support is limited to the installed-path version in the support matrix; OpenCode 2.3.0 on macOS is not claimed.
  • Windows is out of scope. WSL is untested and is not a substitute for Linux/tmux evidence.
  • Git-spec installs fail upstream in OpenCode 2.2.7. Use the npm package or a loopback registry.
  • A package-only install does not include the checkout-based doctor.

Documentation contract ​

npm run docs:check reads the same constants used by validation. It fails when this page, the README, the compatibility page, the CI matrices, or the generated reference disagree with the canonical host, Node, package, or contract values.

Next ​

Released under the MIT License.