Cmd Provider

A provider and plugin for OpenCode that connects to the Command Code Provider API. This enables you to use ALL Command Code plans — Go, GOAT, Pro, Max 10×, Max 20×, Provider, Team, and Enterprise — with OpenCode.

Disclaimer: This is an unofficial, community-maintained integration. It is not affiliated with, endorsed by, or supported by Command Code. You need your own Command Code account and API key or subscription. Command Code's terms, availability, and pricing apply.

Install

Add the package to your OpenCode configuration:

// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-cmd-provider"],
}

That's it. The plugin bundles a snapshot of the Command Code model catalog and auto-registers the commandcode provider — npm package, name, API key env var, and every model — when OpenCode loads. No provider.commandcode block, no models map, no network access needed. All Command Code models appear in /models with the [CMD] display-name prefix (e.g. [CMD] Claude Sonnet 5) so they aren't confused with same-named models from other providers.

You can still declare your own provider.commandcode entry to customize behavior; your declarations always win and the snapshot fills in only what's missing:

• Declared provider-level settings (name, options, baseURL, env) are kept as you wrote them.
• Declared models stay exactly as you wrote them — the snapshot never modifies or removes them, and models that left the catalog remain usable.
• whitelist/blacklist on a declared entry filter the auto-registered models too, keeping the picker uncluttered.

The catalog snapshot is refreshed at every release; newly published Command Code models appear after a plugin update.

Start or reload OpenCode, then authenticate:

/connect

Select Command Code, complete the browser flow, and pick a model with /models.

Authentication

Browser login

Run /connect in OpenCode and select Command Code. The browser flow stores the returned credential in OpenCode's auth store.

If automatic transfer from the browser fails, copy the API key shown by Command Code and export it as COMMANDCODE_API_KEY (see below).

Environment variable

export COMMANDCODE_API_KEY="user_..."

Legacy auth files

The provider also reads existing credentials from:

• ~/.commandcode/auth.json
• ~/.omp/agent/auth.json
• ~/.pi/agent/auth.json

Supported examples:

{
  "apiKey": "user_..."
}

{
  "command-code": {
    "type": "api",
    "key": "user_..."
  }
}

{
  "commandcode": "user_..."
}

Usage

Pick a model with /models, or run non-interactively:

opencode run --model commandcode/claude-sonnet-5 "hello"

Model discovery and offline behavior

The plugin ships a snapshot of the Command Code model catalog (src/catalog/snapshot.ts) and auto-registers every model into OpenCode's config at startup. Model availability changes when the package is updated: the snapshot is regenerated from the live catalog at every release via npm run refresh:snapshot.

Auto-registration adds no network latency to OpenCode startup — the snapshot is bundled, and the plugin never contacts the Command Code API to list models. The plugin works fully offline; model availability never depends on the catalog endpoint being reachable.

The following environment variables are intended for tests, local mocks, and compatible API endpoints:

Variable	Purpose
COMMANDCODE_API_BASE	Override the Command Code API base URL
COMMANDCODE_FACTS_URL	Override the bundled models.md URL
COMMANDCODE_MODALITIES_URL	Override the CLI bundle URL

Reasoning support

Reasoning metadata is enriched only for models whose Command Code effort support is known. Supported levels are sent as the documented reasoning_effort request field; off, unsupported levels, and newly discovered models without metadata do not add reasoning fields to the request. No prompt instructions are injected.

Reasoning blocks from completed assistant turns are not replayed to Command Code in later requests; only the user-visible text and completed tool calls are sent back as history. This prevents prior private reasoning traces from interfering with reasoning on follow-up turns.

Image input

Image input is advertised only for models marked with the image input modality in the Command Code CLI bundle. The release-time refresh generates this map into src/catalog/facts.ts; unknown models default to text-only until their upstream metadata is reviewed.

For vision-capable models, image blocks from user messages and tool results are forwarded in Command Code's data-URL wire format. Text-only models reject image content before making a network request instead of silently dropping it.

Pricing display

The Command Code Provider API does not currently include prices in its model catalog. This provider generates a table from the bundled models.md catalog so OpenCode can display estimated request costs.

Models missing from that table display zero cost in OpenCode. This does not mean Command Code will bill the request at zero. Check the current Command Code pricing before relying on the displayed value.

Update and remove

Update the installed package, or remove it from the plugin array in your opencode.json (the auto-registered provider.commandcode entry is injected by the plugin, so there is no config block to remove). The npm package is cached under OpenCode's plugin cache (~/.cache/opencode/packages/); remove the cached directory to fully uninstall.

Development

Build, then run the full suite:

npm install
npm run build
npm test
npm run format:check

The headless end-to-end test runs the real OpenCode CLI against a mock Command Code server through the built package:

npm run build && npm run test:e2e

scripts/opencode-fixture.mjs writes a throwaway opencode.json wiring only the local build as a plugin — no declared provider or models — so opencode models proves auto-registration against a real opencode binary. test:e2e is a local dev gate (it needs the real opencode binary on PATH) and is excluded from npm test.

See CONTRIBUTING.md for local setup and tests. See RELEASE.md for the release process.

Credits

Inspired by pi-commandcode-provider.

License

MIT