OpenCode integrations connect OpenCode to third-party applications and services. Each integration is one self-contained OpenCode V2 plugin, published as one npm package @neuralnomads/opencode-<app> with its tools, skills, data and scripts. An application-side part (an add-on, a panel), when there is one, ships inside the package but is installed separately, by an explicit action, and is checked by version.
Integrations work in every OpenCode client: the terminal UI, the desktop app and CodeNomad. CodeNomad gives the best experience (a catalog, per-integration status, one-click host install and attaching an open application to a conversation), but no integration depends on it.
Status: draft 0.2 (
spec: 0, RPC contract 1). The specification and the packages are previews. Nothing is published to npm yet.
| Family | Principle | Examples |
|---|---|---|
native |
An authenticated loopback host inside the application owns the document state; the plugin exposes bounded <app>_context / <app>_apply intents. The conversation happens in an application panel or in any OpenCode client by attaching the open application. |
Blender (pilot), Gaffer, Houdini |
vendor-mcp |
The plugin declares the vendor's official MCP server (never redistributed), checks its preconditions and adds tested skills and workflows. | DaVinci Resolve |
api |
The plugin calls a remote API directly. | Microsoft 365 |
None is released yet. The reviewed list lives in catalog.json.
| Integration | Family | Status |
|---|---|---|
| OpenCode for Blender | native |
preview (pilot) |
Gaffer, Houdini, DaVinci Resolve and Microsoft 365 follow.
Any OpenCode client: add the package to the plugins list of your global OpenCode configuration (~/.config/opencode/opencode.json):
An entry with settings is an object: { "package": "@neuralnomads/opencode-<app>@^0.2", "options": { … } }.
OpenCode installs the package on its next start. Integrations of the native family are installed in the global configuration only.
Open Status → Plugins, choose Add, and enter the package name; or use the Integrations extension, which lists the catalog, shows each integration's state and installs the application part.
| Path | Content |
|---|---|
spec/ |
Specification of OpenCode integrations and its JSON Schemas (spec/schemas/) |
catalog.json |
Reviewed catalog, published as the asset of a catalog-v<n> release |
packages/integration-kit/ |
Shared core bundled into every integration plugin |
packages/conformance/ |
Conformance checks of markers, catalog and packaging |
integrations/<app>/ |
plugin/ (the npm package), host/ (the application part), test/ |
scripts/ |
Repository tooling, including the trace scan |
Node.js 22.18 or later runs the TypeScript sources directly. The tests of the reference Python discovery client need Python 3 (python3, or python on Windows; set PYTHON to choose another interpreter).
npm ci
npm run lint
npm run typecheck
npm test
npm run check:markers
npm run build && npm run scanSee CONTRIBUTING.md and SECURITY.md.
{ "plugins": ["@neuralnomads/opencode-<app>@^0.2"] }