oh-my-opencode-slim v2 — Orquestração em Background, Council, Deepwork e Mais

O plugin oh-my-opencode-slim passou de um delegador sequencial para um scheduler assíncrono com agentes de fundo, council multi-modelo e deepwork estruturado. Quem usa OpenCode para tarefas complexas vai querer perceber o que mudou.

O oh-my-opencode-slim tornou-se no plugin de orquestração preferido de quem usa OpenCode e quer mais do que um agente a fazer tudo. A versão 1.x fazia o trabalho: o Orchestrator delegava tarefas a especialistas, um de cada vez, e esperava que cada um terminasse antes de avançar.

O problema é a lentidão. Com 3 agentes, o tempo total era a soma dos tempos individuais. Para tarefas simples servia. Para refactors complexos, research em paralelo, ou implementações multi-ficheiro, ficava curto.

A versão 2.0.1 muda isso. O Orchestrator passou a ser um scheduler que lança agentes em background, trackeia eventos de conclusão, e integra resultados em paralelo. Não é uma atualização incremental. É um salto de versão que redefine o que o plugin faz.

Neste guia completo vais aprender:

• O que são Background Agents e como funcionam na prática
• O novo agente Council com múltiplos modelos de IA a comparar respostas
• O workflow Deepwork para tarefas de codificação pesadas
• O Companion, a janela flutuante que mostra agentes ativos
• A Plugin Skill integrada para auto-configuração segura do plugin
• O agente Observer para análise visual
• Todas as melhorias de configuração da v2
• Tabelas de comparação v1.x vs v2.0.1

⬆ Interface conceptual da v2: Orchestrator a delegar tarefas em paralelo para 6 agentes especialistas

O Salto de Versão: v1.x → v2.0.1

Antes de entrarmos nos detalhes, vale a pena perceber a diferença fundamental entre as duas versões. A v1.x usava um modelo de delegação sequencial. O Orchestrator invocava um agente, esperava pelo resultado, e só depois passava ao próximo. Funcional, mas desperdiçava o potencial de paralelismo.

A v2.0.1 troca este modelo por orquestração assíncrona em background. O Orchestrator analisa o trabalho a fazer, divide-o em tarefas, e lança os agentes certos em paralelo. Cada agente recebe um task ID único e corre de forma independente. O Orchestrator continua a gerir a sessão principal enquanto os agentes trabalham em segundo plano.

⬆ Comparação visual entre o modelo sequencial da v1.x (esquerda) e a orquestração em background da v2.0.1 (direita)

Background Agents: A Maior Mudança

A funcionalidade que define a v2. Os background agents são o coração do novo modelo de orquestração.

Na prática, o Orchestrator funciona como um scheduler. Quando recebe uma tarefa complexa, ele:

1. Analisa o problema e divide-o em sub-tarefas
2. Seleciona os agentes certos para cada sub-tarefa
3. Delega cada tarefa com um session ID único
4. Monitoriza eventos de conclusão à medida que chegam
5. Reconcilia os resultados quando todos terminam
6. Verifica o trabalho feito antes de continuar

Cada agente especialista corre numa sessão OpenCode separada, o que significa que têm o seu próprio contexto, modelo, e ferramentas. Dois agentes podem ler e escrever ficheiros diferentes ao mesmo tempo sem conflitos.

Nota importante: O Orchestrator evita write ownership conflicts. Se dois agentes precisam de modificar o mesmo ficheiro, o scheduler serializa essas operações para evitar corrupção de dados. O modelo de ownership é gerido automaticamente.

Isto é prático. Se precisas que o Explorer analise a codebase, o Librarian pesquise documentação, e o Fixer implemente correções ao mesmo tempo, a v2 faz isso de forma nativa. Na v1.x terias de esperar por cada um em sequência.

O tempo total de execução passa de soma dos tempos (v1) para máximo dos tempos (v2). Para tarefas com 3-4 agentes independentes, a diferença é de 3x-4x mais rápido.

Agente Council: Múltiplos Modelos em Paralelo

O Council é um dos agentes mais interessantes da v2. Em vez de confiar num único modelo de IA para tomar decisões, o Council envia o mesmo problema para vários modelos em paralelo, recolhe as respostas, e sintetiza a melhor solução.

Imagina que estás a decidir entre duas arquiteturas para um refactor. Perguntas ao Council, e ele:

• Envia a questão para 3-4 modelos diferentes (definidos em council.presets)
• Cada modelo responde de forma independente
• O agente Council (um modelo de síntese forte) analisa todas as respostas
• Devolve uma resposta consolidada com o melhor de cada perspetiva

O Council não é invocado automaticamente pelo Orchestrator. Isto é intencional: correr múltiplos modelos ao mesmo tempo consome muitos tokens. Em vez disso, invocas manualmente quando precisas:

@council compara estas duas arquiteturas para o refactor do módulo de auth

A configuração é feita através de council.presets no ficheiro de configuração. Cada preset define que modelos participam como councillors e qual o modelo que faz a síntese final.

{
  "council": {
    "presets": {
      "default": {
        "councillors": [
          "openai/gpt-5.5",
          "anthropic/claude-fable-5",
          "google/gemini-3.5-flash"
        ],
        "synthesis": "openai/gpt-5.5"
      }
    }
  }
}

Quando usar o Council: decisões arquiteturais, comparação de abordagens, code review crítico, debugging complexo onde uma segunda opinião (ou terceira, ou quarta) faz diferença. Para tarefas simples, não compense o custo extra.

Deepwork Workflow: Para Tarefas Pesadas

O Deepwork é um workflow estruturado para tarefas de codificação que exigem planeamento, revisão e execução em fases. Não é para correções rápidas. É para refactors grandes, alterações multi-ficheiro, e implementações de alto risco.

O workflow segue este ciclo:

1. Início: invocas com /deepwork <tarefa>
2. Planeamento: o sistema cria um ficheiro de plano persistente em markdown local
3. Revisão: o agente Oracle revê o plano antes de começar a implementação (gate obrigatório)
4. Execução por fases: cada fase do plano é implementada sequencialmente
5. Verificação: cada fase é verificada antes de avançar para a seguinte
6. Conclusão: o plano é marcado como completo

O ficheiro de plano fica guardado em disco, o que significa que podes interromper o trabalho, fechar o terminal, e voltar mais tarde. O /deepwork retoma de onde paraste.

/deepwork refatorar o módulo de autenticação para usar tokens JWT com refresh

Nota: O gate de revisão do Oracle é obrigatório por defeito. Isto significa que o Deepwork não começa a implementar até o Oracle aprovar o plano. Se quiseres saltar a revisão (não recomendado), precisas de alterar a configuração da skill.

Companion: Janela Flutuante ao Vivo

Quando tens vários agentes a trabalhar em background, é difícil saber o que está a acontecer. O Companion resolve isso: é uma janela flutuante de desktop (opcional) que mostra o estado dos agentes ativos em tempo real.

⬆ Preview do Companion a mostrar 4 agentes ativos em background com o Deepwork em progresso

Cada agente aparece com o seu nome, estado atual, e task ID. Vês quem está a trabalhar, quem já terminou, e há quanto tempo a sessão está ativa. O Companion também mostra comandos recentes, como o /deepwork que iniciou a tarefa atual.

Por omissão, o installer da v2 pergunta se queres ativar o Companion (resposta padrão: sim). Podes configurar:

• Posição no ecrã (canto inferior direito, esquerdo, etc.)
• Tamanho da janela
• Ativar/desativar quando quiseres
• Integração com Tmux e Zellij: cada agente abre num painel dedicado

Dica: A integração com multiplexer (Tmux ou Zellij) é altamente recomendada pelo autor do plugin. Cada agente especialista abre no seu próprio painel, o que te permite ver o trabalho a acontecer ao vivo enquanto o Orchestrator continua a coordenar a sessão principal.

Plugin Skill: Auto-Configuração Segura

Uma das adições mais subtis mas importantes da v2 é a skill integrada do plugin (oh-my-opencode-slim skill). Esta skill permite ao Orchestrator configurar e afinar o próprio plugin durante a sessão.

Isto significa que podes pedir ao Orchestrator para ajustar o plugin sem saíres da sessão. Exemplos do que a skill pode fazer:

• Ajustar modelos — mudar o modelo de um agente específico
• Modificar prompts: alterar o prompt de um especialista
• Criar custom agents: adicionar novos agentes à equipa
• Gerir MCP permissions: que agentes acedem a que servidores MCP
• Trocar presets: mudar de preset ativo em runtime
• Desativar agentes: ligar/desligar agentes opcionais

A skill tem permission rules para evitar auto-modificação perigosa. Não podes, por exemplo, desativar o Orchestrator ou remover agentes críticos. É seguro usar sem micro-gerir.

Observer: O Olho Que Vê

O agente Observer é um agente de visão opcional. Se o teu modelo de Orchestrator não for multimodal (ou seja, não consegue processar imagens), o Observer trata disso.

Ele consegue ler:

• Screenshots: analisa imagens de ecrã
• Diagramas: interpreta diagramas de arquitetura, fluxos, etc.
• PDFs: extrai texto e estrutura de documentos
• Imagens em geral: qualquer formato visual

O Observer está desativado por omissão. Para o ativar:

1. Define disabled_agents: [] na configuração
2. Configura um modelo com capacidade visual para o agente observer

O preset opencode-go gerado pelo installer já faz isto automaticamente, porque o modelo GLM do Orchestrator não é multimodal. Nesse preset, o Observer usa opencode-go/kimi-k2.6.

Melhorias de Configuração

A v2 traz várias melhorias na configuração que tornam o plugin mais flexível e resiliente.

Fallback Arrays de Modelos

Cada agente pode ter um array de modelos em vez de um único. Se o primeiro modelo falhar (rate limit, timeout, erro de API), o próximo na lista é tentado automaticamente. Isto torna a configuração muito mais robusta:

{
  "orchestrator": {
    "model": [
      "opencode-go/deepseek-v4-pro",
      { "id": "openai/gpt-5.5", "variant": "high" }
    ]
  }
}

Preset Switching em Runtime

Podes definir múltiplos presets no ficheiro de configuração e trocar entre eles sem reiniciar. Por exemplo, um preset para uso diário (modelos mais baratos) e outro para tarefas críticas (modelos mais potentes):

/preset opencode-go    # muda para o preset opencode-go
/preset production     # muda para um preset de produção
/preset cheap          # muda para preset econômico

Config JSONC

O ficheiro de configuração agora suporta JSONC (JSON com comentários). Isto parece um detalhe pequeno, mas faz diferença quando tens um ficheiro de configuração complexo com dezenas de agentes e presets:

{
  // Preset principal para uso diário
  "preset": "opencode-go",
  /* Comentários multi-linha também funcionam */
  "presets": {
    "opencode-go": {
      "orchestrator": { "model": "opencode-go/glm-5.1" }
    }
  }
}

Schema JSON

O schema de configuração foi atualizado para a v2 e inclui todas as novas opções. O ficheiro está disponível em:

https://unpkg.com/oh-my-opencode-slim@latest/oh-my-opencode-slim.schema.json

Editores como VS Code ou o opencode.json podem usar este schema para autocomplete e validação.

Tabela Comparativa Completa

Conclusão

A versão 2.0.1 do oh-my-opencode-slim não é apenas uma atualização, é uma reescrita fundamental do modelo de orquestração. A passagem de delegação sequencial para background assíncrono muda a forma como usas o plugin no dia-a-dia.

O que ganhas:

• Velocidade: agentes em paralelo reduzem o tempo total para o máximo (não a soma) dos tempos individuais
• Council: decisões mais informadas com contributos de múltiplos modelos
• Deepwork: segurança para refactors grandes com planeamento e revisão obrigatória
• Visibilidade: Companion mostra o que está a acontecer em tempo real
• Resiliência: fallback de modelos, presets em runtime, configuração mais robusta

Se usas o oh-my-opencode-slim v1.x, a migração para v2.0.1 é direta. O installer trata de tudo. Se és novo no plugin, esta é a versão para começar. A instalação é simples:

bunx oh-my-opencode-slim@latest install

E depois, dentro do OpenCode, corre ping all agents para verificar que está tudo pronto.

Recursos

• oh-my-opencode-slim no GitHub (alvinunreal)
• Site oficial do plugin
• Documentação de Background Orchestration
• Guia do Council
• Configuração do Companion
• Skills do Plugin (Deepwork, oh-my-opencode-slim)
• Referência Completa de Configuração
• OpenCode - Site Oficial
• Integração Tmux / Zellij