Skip to content

Configuration

The first file found wins:

  1. .opencode/resolve.json
  2. opencode-resolve.json
  3. ~/.config/opencode/resolve.json
  4. ~/.config/opencode/opencode-resolve.json

Inline plugin options override file config.

KeyDefaultPurpose
enableddefault agentsAgents to inject.
models{}Model aliases and role pins.
agents{}Per-agent overrides.
preserveNativetruePreserve native OpenCode agents.
context7trueRegister Context7 MCP if missing.
commandsfalseAdd /resolve, /resolve-code, /resolve-review.
autoApprovetrueCompatibility flag.
autoUpdatetrueAllow additive installer migrations.
languageautoPrompt language preference.
maxParallelSubagentsunsetPrompt-level soft limit for coder fan-out.

Unknown keys fail fast.

By default, all resolve agents inherit OpenCode’s top-level model.

Resolution order:

  1. agents.<name>.model
  2. models.<name>
  3. OpenCode top-level model
  4. OpenCode fallback
{
"models": {
"bronze": "zai-coding-plan/glm-4.5",
"silver": "zai-coding-plan/glm-5.1",
"gold": "openai/gpt-5.5",
"explorer": "bronze",
"coder": "silver",
"resolver": "gold"
}
}

With "context7": true, the plugin registers:

{
"mcp": {
"context7": {
"type": "remote",
"url": "https://mcp.context7.com/mcp"
}
}
}

If mcp.context7 already exists, it is preserved.