Official

opencode-v2

OpenCode 2 agent provider: runs opencode serve (2.x) and talks to its /api over HTTP and server-sent events.

The app opens the listing; nothing installs until an agent in your Plugins workspace has read the files and you enable the plugin. In a terminal: cvg install convergence/opencode-v2@0.1.0

Permissions in 0.1.0

  • Provide agents agents.provideMediumAdds agents to the app.Provide the OpenCode 2 agent, and serve plugin tools to it through the host's loopback MCP server
  • Run named programs processMediumStarts the listed programs.Run the OpenCode 2 server (`opencode serve`, or the binary you choose in Settings) and read its versionPrograms: opencode${settings.binaryPath}
  • Network access netMediumConnects to the listed hosts.Talk to the OpenCode server it starts on this computer, at the port it picks for each launch, and to the external server you choose in SettingsHosts: localhost:*${settings.serverUrl}
  • Environment variables envMediumReads the listed environment variables.Read the user name and password of the OpenCode serverVariables: OPENCODE_SERVER_USERNAMEOPENCODE_SERVER_PASSWORDCONVERGENCE_OPENCODE_SERVER_PASSWORD

Files

plugin.json1.9 KB
{
  "id": "convergence/opencode-v2",
  "name": "opencode-v2",
  "version": "0.1.0",
  "description": "OpenCode 2 agent provider: runs `opencode serve` (2.x) and talks to its /api over HTTP and server-sent events.",
  "pluginApi": ">=2 <3",
  "main": "main.ts",
  "contributes": {
    "agents": [{ "id": "opencode-v2", "name": "OpenCode", "qualifier": "2" }],
    "settings": {
      "title": "OpenCode 2",
      "properties": {
        "binaryPath": {
          "type": "path",
          "kind": "file",
          "title": "OpenCode 2 binary",
          "description": "The opencode 2.x program to run for the local server. Empty runs the one your login PATH finds first; choose one when that is a 1.x install.",
          "placeholder": "~/.local/bin/opencode"
        },
        "serverUrl": {
          "type": "url",
          "title": "External server",
          "description": "The address of an OpenCode 2 server you run yourself (opencode serve). Empty starts a local server. Saving an address asks you to allow the connection.",
          "placeholder": "http://127.0.0.1:4096"
        }
      }
    }
  },
  "permissions": {
    "agents.provide": {
      "reason": "Provide the OpenCode 2 agent, and serve plugin tools to it through the host's loopback MCP server"
    },
    "process": {
      "programs": ["opencode", "${settings.binaryPath}"],
      "reason": "Run the OpenCode 2 server (`opencode serve`, or the binary you choose in Settings) and read its version"
    },
    "net": {
      "hosts": ["localhost:*", "${settings.serverUrl}"],
      "reason": "Talk to the OpenCode server it starts on this computer, at the port it picks for each launch, and to the external server you choose in Settings"
    },
    "env": {
      "vars": ["OPENCODE_SERVER_USERNAME", "OPENCODE_SERVER_PASSWORD", "CONVERGENCE_OPENCODE_SERVER_PASSWORD"],
      "reason": "Read the user name and password of the OpenCode server"
    }
  }
}

Versions

VersionPublishedPlugin APISizePermissionsStatus
0.1.0latestOct 5, 2026>=2 <345.1 KB4 permissionsListed

Reviews and comments

0 threads · 0 reviews

No comments yet.