@mr.mm/opencode-omniroute-plugin

OpenCode plugin for the OmniRoute AI Gateway.

Pulls a live model catalog from /v1/models, aggregates combos via /api/combos, maps OmniRoute capabilities to the OpenCode ModelV2 contract, and supports multiple side-by-side OmniRoute instances.

Fork of @omniroute/opencode-plugin with additional fixes — see Changes from upstream.

npm install @mr.mm/opencode-omniroute-plugin
# or
bunx add @mr.mm/opencode-omniroute-plugin

For local development, clone and build:

git clone https://github.com/mrmm/opencode-omniroute-plugin
cd opencode-omniroute-plugin
bun install && bun run build

Then reference the dist directly in opencode.jsonc:

{
  "plugin": [
    [
      "/path/to/opencode-omniroute-plugin/dist/index.js",
      { "providerId": "omniroute" },
    ],
  ],
}

// ~/.config/opencode/opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    [
      "@mr.mm/opencode-omniroute-plugin",
      {
        "providerId": "omniroute",
        "baseURL": "https://your-omniroute-instance.example.com",
        "modelCacheTtl": 300000,
      },
    ],
  ],
}

opencode auth login --provider omniroute
# prompts for API key, writes to ~/.local/share/opencode/auth.json

Note: Use --provider explicitly. opencode auth login omniroute is parsed as a positional URL argument on OC ≤1.15.5 and fails. Tracked upstream.

OC ≤1.15.5 dedupes plugin loads by module path — two entries pointing at the same file collapse to one. Workaround: install the package twice into separate directories.

mkdir -p ~/.config/opencode/plugins/omniroute-prod
mkdir -p ~/.config/opencode/plugins/omniroute-staging
npm install --prefix ~/.config/opencode/plugins/omniroute-prod    @mr.mm/opencode-omniroute-plugin
npm install --prefix ~/.config/opencode/plugins/omniroute-staging @mr.mm/opencode-omniroute-plugin

{
  "plugin": [
    [
      "./plugins/omniroute-prod/node_modules/@mr.mm/opencode-omniroute-plugin/dist/index.js",
      { "providerId": "omniroute", "baseURL": "https://or.example.com" },
    ],
    [
      "./plugins/omniroute-staging/node_modules/@mr.mm/opencode-omniroute-plugin/dist/index.js",
      {
        "providerId": "omniroute-staging",
        "baseURL": "https://or-staging.example.com",
      },
    ],
  ],
}

Fixes applied on top of @omniroute/opencode-plugin at v3.8.9:

bun install
bun run build   # tsup → dist/
bun test tests/ # 228 tests, ~150ms

Tag a version to trigger the release workflow (builds, tests, publishes to npm, creates GitHub Release):

git tag v0.1.2 && git push origin v0.1.2

• Node >=22 or Bun >=1.1
• OpenCode >=1.15 with @opencode-ai/plugin >=1.14.49

MIT — see LICENSE.