🎯 Escolher: instalacao global ou por projeto
A primeira decisao e se voce quer o oh-my-openagent ativo em todos os seus projetos (global) ou apenas neste projeto (local). Cada abordagem tem vantagens diferentes.
💡 Comparacao: Global vs Por Projeto
| Criterio | Global | Por Projeto |
|---|---|---|
| Ativa em | Todos os projetos | So nesse projeto |
| Ideal para | Uso pessoal diario | Demos, aulas, testes |
| Configuracao | ~/.config/opencode/ | .opencode/ na raiz |
| Recomendacao | Recomendado | Para experimentar |
📊 Dica pratica
Se voce esta comecando agora, escolha global. Voce pode mudar depois. A maioria dos usuarios prefere ter o swarm disponivel em todos os projetos.
⚡ Passo 1: identificar suas assinaturas
O comando de instalacao precisa saber quais provedores voce tem para configurar os agentes corretamente. Identifique qual cenario se aplica a voce:
💡 Cenarios mais comuns
- •Claude + Gemini (Antigravity): O cenario mais comum e recomendado. Claude para tarefas criticas, Gemini para suporte
- •So Claude: Funciona muito bem. Todos os agentes usam modelos Anthropic
- •Claude + ChatGPT Plus: Boa combinacao. Heterogeneidade de modelos melhora qualidade
- •So modelos gratuitos: Funciona! Qualidade menor, mas voce consegue completar todo o curso
📦 Passo 2: executar o instalador
Agora vem o momento da acao. Um unico comando instala tudo — o oh-my-openagent configura os agentes, cria os system prompts, registra o plugin e prepara o swarm. Escolha o comando correto para o seu cenario:
💡 Comandos de instalacao por cenario
# Caso mais comum: Claude + Gemini (Antigravity)
bunx oh-my-opencode install --no-tui \
--claude=yes --gemini=yes --copilot=no --opencode-zen=yes
# So Claude
bunx oh-my-opencode install --no-tui \
--claude=yes --gemini=no --copilot=no --opencode-zen=yes
# Claude + ChatGPT Plus
bunx oh-my-opencode install --no-tui \
--claude=yes --openai=yes --gemini=no --copilot=no
# So modelos gratuitos
bunx oh-my-opencode install --no-tui \
--claude=no --openai=no --gemini=no --copilot=no --opencode-zen=yes📊 O que acontece durante a instalacao
- 1. O instalador baixa os templates de agentes (Sisyphus, Hephaestus, Prometheus, etc.)
- 2. Configura os system prompts otimizados para cada papel
- 3. Registra o plugin no OpenCode (modifica opencode.json)
- 4. Atribui modelos padrao conforme seus provedores
- 5. Pronto! O swarm esta instalado
🔍 Passo 3: verificar a instalacao
Apos a instalacao, voce precisa confirmar que o plugin foi registrado corretamente. Isso evita descobrir problemas no pior momento — no meio de uma execucao.
💡 Verificando o registro do plugin
# Verificar que o plugin foi registrado
cat ~/.config/opencode/opencode.json
# Voce deve ver algo como:
# {
# "plugins": ["oh-my-opencode"],
# ...
# }
# Se "oh-my-opencode" aparece no array de plugins, esta tudo certo!📊 O que procurar no arquivo
- plugins: Deve conter "oh-my-opencode" no array
- agents: Pode listar os agentes configurados (Sisyphus, Hephaestus, etc.)
- Se o arquivo nao existe: A instalacao falhou — repita o passo anterior
🚀 Passo 4: abrir OpenCode e conferir a mudanca
Este e o momento da verdade. Ao abrir o OpenCode agora, a interface deve ser completamente diferente do que era antes. Os modos Build e Plan desaparecem e dao lugar aos agentes do swarm.
💡 Abrindo com o swarm ativo
# Entrar na pasta do projeto
cd ~/meu-primeiro-swarm
# Abrir o OpenCode
opencode
# ANTES (sem oh-my-openagent):
# Modos: Build | Plan
#
# AGORA (com oh-my-openagent):
# Agentes: Sisyphus | Hephaestus | Plan Builder | Plan Executor
#
# Voce tambem pode ver os subagentes:
# Oracle, Librarian, Explore, Multimodal Looker📊 Confirmacao visual
- ✅Sisyphus aparece como agente principal (orquestrador)
- ✅Hephaestus aparece como agente executor
- ✅Plan Builder (Prometheus) disponivel via Tab
- ✅Build e Plan nao aparecem mais (foram substituidos)
🛠️ Solucao de problemas comuns
Se algo nao funcionou como esperado, nao entre em panico. Aqui estao os 5 erros mais comuns e como resolver cada um:
💡 Top 5 erros e solucoes
1. "bunx: command not found"
Bun nao esta instalado ou o terminal nao foi reaberto. Solucao: curl -fsSL https://bun.sh/install | bash e reabrir terminal.
2. Plugin nao aparece no OpenCode
O plugin nao foi registrado. Solucao: verifique cat ~/.config/opencode/opencode.json e rode o instalador novamente.
3. Modelos com prefixo errado
Nomes como "claude-opus" em vez de "anthropic/claude-opus-4-6". Solucao: use sempre o formato provedor/modelo.
4. Sisyphus responde generico (sem personalidade de swarm)
O plugin instalou mas os system prompts nao foram aplicados. Solucao: rode bunx oh-my-opencode install novamente.
5. Agentes nao trabalham em paralelo
Versao do OpenCode pode ser antiga. Solucao: atualize o OpenCode para a versao mais recente.
📚 Resumo do Modulo
Proximo Modulo:
4.3 - Configurando os modelos de cada agente