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.

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 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.

Overview

Connect a client

Connections

Share skills and plugins

Use OpenWork in OpenCode