Use OpenWork in OpenCode

The OpenWork plugin for OpenCode 2 brings your organization’s AI Gateway models and OpenWork MCP into a plain OpenCode install. You sign in once; OpenCode loads them every time it starts. The opencode-openwork package is published and ready to install. You do not need the OpenWork desktop app.

Requirements

OpenCode 2 with the integration, provider, and MCP plugin APIs. The plugin is tested with 2.0.26; OpenCode 1 is not supported.
An OpenWork account and organization membership. An admin grants the models, skills, and connections you can use.

Check your installed version first:

opencode --version

Installing the plugin does not install or upgrade OpenCode.

Install the plugin

opencode plugin add opencode-openwork

opencode auth login openwork

Choose Browser. Sign in to OpenWork, pick your organization and approve. OpenCode finishes signing in on its own.On SSH or a machine without a browser, use opencode auth login openwork --method code, open the link on any device and confirm the code.

Check what you got

opencode auth list
opencode models | grep ipr_
opencode mcp list

Your AI Gateway models are listed as ipr_…/gwm_…. openwork-cloud gives the agent your organization’s skills, plugins and connections. Connections your admin made available in other apps appear as openwork-direct-<name>-<id>.

Sign out or switch organizations

opencode auth logout openwork
opencode auth login openwork

Signing out also ends the OpenWork session and removes the models and MCP servers the plugin added. Pick the other organization on the approval page when you sign in again.

Self-hosted or enterprise OpenWork

Point the plugin at your OpenWork API in ~/.config/opencode/opencode.json:

{
  "plugins": [
    { "package": "opencode-openwork", "options": { "apiBaseUrl": "https://api.openwork.example.com" } }
  ]
}

Only models, or only MCP

Set "providers": false or "mcp": false in the plugin options.

No AI Gateway models listed

The plugin shows the AI Gateway providers your organization grants you. Ask an admin to check AI Gateway in OpenWork Cloud. Models the catalog marks as deprecated are hidden.

Only MCP, without the plugin

Add OpenWork MCP to OpenCode directly: Connect OpenCode.

​Requirements

​Install and sign in

​Related integrations

Requirements

Install and sign in

Related integrations