Compartilhamento de Config OpenCode: Agent Padrao, Plugins e Providers

Índice

1. 1. Configuracao atual
2. 2. Precedencia de merge
3. 3. Campos top-level
4. 4. Origem de default_agent = cx-local
5. 5. Stack de plugins (foco)
   1. 5.1 Lista de plugins (nomes npm)
   2. 5.2 opencode-planpilot
   3. 5.3 opencode-workbench
   4. 5.4 opencode-web-preview
   5. 5.5 opencode-cx-agents
   6. 5.6 Recomendacoes de uso
6. 6. Providers e roteamento de modelo

1. Configuracao atual

{
  "$schema": "https://opencode.ai/config.json",
  "autoupdate": false,
  "compaction": {
    "auto": true,
    "prune": true
  },
  "default_agent": "cx-local",
  "model": "openai/gpt-5.3-codex",
  "small_model": "openai/gpt-5.1-codex-mini",
  "plugin": [
    "opencode-planpilot",
    "opencode-workbench",
    "opencode-web-preview",
    "opencode-cx-agents"
  ],
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:CLAUDE_API_KEY}",
        "baseURL": "https://gateway.example.com/v1"
      }
    },
    "google": {
      "options": {
        "apiKey": "{env:GEMINI_API_KEY}",
        "baseURL": "https://gateway.example.com/v1beta"
      }
    },
    "openai": {
      "options": {
        "apiKey": "{env:OPENAI_API_KEY}",
        "baseURL": "https://gateway.example.com/v1",
        "setCacheKey": true
      }
    }
  }
}

2. Precedencia de merge

Precedencia do OpenCode (baixo -> alto):

1. Remote .well-known/opencode
2. Global ~/.config/opencode/opencode.json
3. OPENCODE_CONFIG
4. Project opencode.json
5. Diretorios .opencode (agents/commands/plugins)
6. OPENCODE_CONFIG_CONTENT

A camada global e ideal para defaults duraveis: default_agent, model, small_model, providers e plugins compartilhados.

3. Campos top-level

4. Origem de default_agent = cx-local

cx-local e registrado pelo plugin opencode-cx-agents, sem necessidade de bloco agent manual no arquivo local.

Os canonical agents atuais sao: cx-explore, cx-local e cx-global.

Efeitos:

1. Config global mais enxuta.
2. Se o carregamento do plugin falhar, o agent padrao nao e registrado.

5. Stack de plugins (foco)

5.1 Lista de plugins (nomes npm)

"plugin": [
  "opencode-planpilot",
  "opencode-workbench",
  "opencode-web-preview",
  "opencode-cx-agents"
]

Repositorios GitHub:

• opencode-planpilot
• opencode-workbench
• opencode-web-preview
• opencode-cx-agents

5.2 opencode-planpilot

Papel: execucao estruturada de tarefas complexas.
Capacidades principais:

• modelo unificado: plan -> step -> goal
• separacao explicita de executor ai / human
• auto-continue quando o proximo executor e ai

Uso tipico: tarefas longas em multiplas etapas.

5.3 opencode-workbench

Papel: orquestracao paralela com branch/worktree.
Capacidades principais:

• vinculo explicito entre sessao e worktree
• roteamento por worktree para paralelismo
• rastreabilidade de contexto de branch/tarefa

Uso tipico: multiplas frentes de trabalho no mesmo repositorio.

5.4 opencode-web-preview

Papel: gerenciamento de preview local de frontend.
Capacidades principais:

• descoberta de sessoes de preview
• start/stop de hosts de preview locais
• verificacao de status de preview

Uso tipico: validacao rapida de alteracoes de UI.

5.5 opencode-cx-agents

Papel: fornece agents predefinidos reutilizaveis e baseline de permissoes.
Capacidades principais:

• canonical agents: cx-explore, cx-local, cx-global
• perfis de permissao de escrita:
  • cx-local: foco no workspace, external_directory: ask
  • cx-global: escrita entre diretorios, external_directory: allow
• coopera com opencode-planpilot, opencode-workbench e opencode-web-preview, mantendo visibilidade de ferramentas

Uso tipico: padronizar estrategia de agents entre repositorios com escolhas de escrita baseadas em risco.

5.6 Recomendacoes de uso

1. Use default_agent = cx-local como padrao seguro.
2. Mude para cx-global apenas quando escrita entre diretorios for realmente necessaria.
3. Ao iniciar, confirme que cx-explore / cx-local / cx-global estao visiveis.

6. Providers e roteamento de modelo

Layout atual: um dominio de gateway com rotas separadas por provider.