🔌 oh-my-openagent na pratica

O oh-my-openagent (OMO) e um plugin que transforma o OpenCode (editor de codigo com IA) em um sistema multiagente completo. Com mais de 41 mil stars no GitHub, e uma das formas mais acessiveis de experimentar swarms sem precisar escrever uma linha de codigo de orquestracao. A instalacao e feita via bunx opencode — o Bun (runtime JavaScript) e a unica dependencia.

A configuracao envolve dois arquivos: opencode.json (na raiz do projeto) define qual provider e modelo usar como padrao, e .opencode/oh-my-opencode.jsonc permite customizar qual modelo cada agente do swarm utiliza. Voce pode misturar providers — Anthropic para o orquestrador, OpenAI para o coder, modelos gratuitos para exploracao — otimizando custo e performance por papel.

O modo ultrawork e o modo de execucao mais agressivo do OMO. Voce simplesmente escreve ultrawork seguido da descricao da tarefa, e o swarm inteiro e ativado: o orquestrador Sisyphus analisa a tarefa, classifica o tipo de trabalho, aciona os agentes relevantes e executa ate completar — tudo sem intervencao humana. E o equivalente a dizer "faca tudo e me avise quando terminar".

No modo ultrawork, todos os agentes operam em paralelo quando possivel. O Sisyphus coordena, o Hephaestus escreve codigo, o Explorer escaneia o codebase para fornecer contexto, o Librarian busca documentacao e o Multimodal Looker analisa screenshots se necessario. O resultado e velocidade maxima para tarefas onde voce tem clareza total do que quer — landing pages, refatoracoes, implementacoes de features com spec clara.

O modo Prometheus e o oposto do ultrawork: em vez de executar imediatamente, o agente Prometheus inicia uma entrevista detalhada para entender completamente o que voce precisa antes de comecar. Ele faz perguntas sobre escopo, restricoes, tecnologias preferidas, publico-alvo e criterios de sucesso. Somente depois de construir um plano completo e obter sua aprovacao e que o Sisyphus comeca a executar.

Para ativar o Prometheus, basta pressionar Tab no OpenCode. O agente planificador assume e comeca o questionario. Depois de 5-10 perguntas (geralmente), ele apresenta um plano estruturado com etapas, agentes responsaveis e estimativa de tempo. Voce revisa, ajusta se necessario e digita /start-work para iniciar a execucao. Essa abordagem e ideal para projetos novos, tarefas ambiguas ou quando voce ainda esta explorando possibilidades.

O Sisyphus e o orquestrador do OMO — o agente central que analisa cada tarefa e decide qual combinacao de agentes e abordagem usar. Ele categoriza automaticamente as tarefas em quatro categorias: Visual Engineering (interfaces, CSS, layouts), Deep Research (analise profunda, investigacao de bugs complexos), Quick Changes (ajustes rapidos, fixes pontuais) e UltraBrain (tarefas que exigem raciocinio complexo e planejamento).

Cada categoria aciona uma combinacao diferente de agentes e modelos otimizados. Visual Engineering ativa o agente de design com modelo especializado em CSS/HTML. Deep Research ativa o Explorer com modelo de raciocinio forte. Quick Changes usa modelo rapido e barato para mudancas triviais. UltraBrain ativa todos os agentes com o modelo mais potente disponivel. Esse roteamento automatico e o que torna o OMO eficiente — voce nao precisa decidir qual agente usar.

Uma das features mais poderosas do OMO e a capacidade de configurar qual modelo cada agente utiliza individualmente. O arquivo .opencode/oh-my-opencode.jsonc permite definir que o Sisyphus (orquestrador) use Claude Opus para raciocinio complexo, o Hephaestus (coder) use Codex para geracao de codigo, o Explorer use um modelo gratuito para leitura de arquivos e o Prometheus use Claude Sonnet para planejamento.

Essa configuracao granular permite otimizar drasticamente o custo sem sacrificar qualidade. O orquestrador precisa de raciocinio forte (modelo caro), mas o explorer so precisa ler e resumir arquivos (modelo barato). O coder precisa de geracao de codigo precisa (modelo especializado), mas o librarian so precisa buscar documentacao (modelo gratuito). Na pratica, essa estrategia pode reduzir custos em 60-80% comparado a usar o modelo mais potente para todos os agentes.

Para demonstrar o OMO em acao, vamos acompanhar a criacao de uma landing page completa do zero usando o modo Prometheus. O fluxo comeca com a entrevista: Prometheus pergunta sobre o produto, publico-alvo, tom de voz, cores, secoes desejadas e referencias visuais. Com base nas respostas, ele gera um plano detalhado com 5-8 etapas.

Apos aprovacao do plano com /start-work, o Sisyphus assume e executa em paralelo: Explorer mapeia a estrutura do projeto, Hephaestus implementa HTML/CSS/JS, Multimodal Looker analisa screenshots para verificar fidelidade visual, e o ciclo de revisao automatica corrige problemas. Em 10-15 minutos, voce tem uma landing page responsiva, com animacoes, SEO basico e pronta para deploy. Todo o processo e transparente — voce ve cada agente trabalhando em tempo real.