Oh My OpenAgent vale a pena? Para quem serve (e para quem não serve)

Fala aí, beleza? Tem ferramenta de IA que gasta a página inteira tentando te convencer a começar a usar agente de código

O Oh My OpenAgent faz o contrário: ele já assume que você vive dentro de um, e que você é do tipo que passa a noite ajustando hook, escrevendo prompt de sistema e debugando agent na mão

A descrição oficial do projeto diz isso na cara: "for your Codex, for your OpenCode"

Então esse post existe pra uma coisa só: te ajudar a se identificar ou a descartar ANTES de perder a tarde instalando 🙂

O que é o Oh My OpenAgent (e quem está por trás):

O omo é um agent harness open source mantido no repositório code-yeongyu/oh-my-openagent, pelo code-yeongyu

A descrição oficial do repo é essa: "omo/lazycodex: The coding agent for tokenmaxxers; the one and only agent harness for complex codebases. For your Codex, for your OpenCode"

Repara nas duas palavras que importam ali: tokenmaxxers e complex codebases

Já é um recorte de público, e é bem estreito

E o que é um "harness", na prática?

Se você conhece a ideia de framework, é bem semelhante: o harness não substitui o agente, ele monta a estrutura em volta do agente

Quem escreve o código continua sendo o modelo que você já usa

O que o omo entrega é o resto: agentes com papel definido, hooks de ciclo de vida, MCPs embutidos, slash commands e um fluxo de trabalho pronto

É a diferença entre você montar seu setup peça por peça e receber um setup inteiro já parafusado

Sinal de projeto vivo (e de coisa que quebra):

O projeto se chamava oh-my-opencode e foi renomeado para oh-my-openagent

A troca de nome quebrou configuração de gente que já usava, e existe issue aberta reportando isso

Isso não é necessariamente ruim, é só informação pra sua decisão: você está entrando num projeto em movimento, não num produto estabilizado

Se a sua base principal não pode parar, guarda esse detalhe

Ultimate, Light e Senpi: qual edição é a sua:

São três edições, e a diferença entre elas não é cosmética: duas entram como plugin num host que você já roda, e uma é standalone

O ponto que decide muita coisa: a Light não tem o registro de agentes do OpenCode nem a família de ferramentas team_*

Ou seja, se o que te atraiu foi a orquestração entre agentes, a Ultimate é o caminho, e o host tem que ser o OpenCode

Bora ver pra quem isso faz sentido?

Para quem o Oh My OpenAgent foi feito:

Pra quem já vive configurando agent por conta própria:

Esse é o público-alvo mais óbvio

Se você já escreveu seus próprios hooks, já montou skill, já quebrou e remontou o seu fluxo umas cinco vezes, o omo te entrega uma base pronta pra você parar de reinventar

Você vai entender o que cada peça faz, porque você já tentou fazer as peças

Pra quem trabalha em base grande e precisa de orquestração:

A Ultimate traz agentes com papéis nomeados e bem distintos

• Sisyphus: o orquestrador principal, que planeja, delega e conduz até a conclusão
• Prometheus: o planejador estratégico, que te entrevista antes de escrever código
• Hephaestus: o trabalhador autônomo profundo

Isso não é enfeite: em base complexa, o problema raramente é "o modelo não sabe programar", é COMO coordenar o trabalho sem espalhar bagunça pelo repositório

Pra quem já é do OpenCode:

Se o OpenCode já é o seu daily driver, você pega a versão completa, sem abrir mão de host

Mas atenção num detalhe que quase ninguém avisa: uma vez instalado, os agentes do omo ficam atrelados ao OpenCode e substituem os agentes padrão que ele traz

Não é um menu que você liga e desliga no humor do dia

Pra quem está no Codex CLI e aceita menos:

A Light é honesta no nome

Você leva os componentes portáveis e os MCPs com escopo de plugin, e fica sem o registro de agentes e sem as ferramentas team_*

Se você topa esse recorte, beleza. Se o que você queria era justo a parte que não vem, melhor saber agora do que depois de instalar

E se você não programa?

Aí esse não é o seu ponto de partida, sério

Harness é ferramenta de quem já opera agente no terminal e sente falta de estrutura

Quem está começando se diverte muito mais explorando o que dá pra resolver sem programar antes de mexer em plugin, hook e MCP

O que vi rodando na prática:

No vídeo eu instalei o Oh My OpenAgent e testei o fluxo completo, e achei o processo de instalação claro e a ferramenta tranquila de usar

A instalação pede um pré-requisito de runtime citado no próprio repositório, e os comandos estão documentados lá

Depois de instalar, rodei o diagnóstico que o próprio projeto oferece, só pra checar se o ambiente estava certo

Gostei disso: ele aponta o que ainda está errado pra você corrigir antes de sair usando

Não instalei todas as integrações opcionais que ele recomenda, e o próprio diagnóstico apontou isso direitinho

O fluxo de planejamento antes de escrever código:

Comecei pelo agente de planejamento (Prometheus) pra fazer do jeito certo

Pedi o plano de um app de controle de hábitos: PWA com front em React, back em Node e banco SQLite, CRUD de hábitos sem login

Exemplo simples, de propósito, só pra demonstrar a ferramenta

O agente faz perguntas antes de fechar o plano, e respondendo essas perguntas o plano fica montado pra prosseguir

Teve até uma etapa extra de brief de aprovação: li o brief, aprovei, e só então ele escreveu o plano de verdade

O rascunho ficou salvo numa pasta do próprio projeto, dá pra abrir e ler numa boa

E eu recomendo MUITO ler tudo, linha por linha

Se o seu inglês não é forte, pede tradução do arquivo, é mais rápido que fingir que leu

No plano do app de exemplo, ele previu cinco componentes independentes

O debate entre agentes e o preço dele:

Depois usei a skill de hyperplan, que faz os agentes debaterem o plano entre si e corrigirem antes de executar qualquer coisa

A primeira tentativa falhou porque eu não tinha o modo de time configurado

Depois de ajustar e reiniciar o OpenCode, funcionou: ele criou subagentes em paralelo, alguns terminaram antes dos outros, esperei o resultado final e ele listou todas as mudanças que aplicou no plano

Agora a parte chata: usar hyperplan sem ter lido o plano antes é queima de token e de tempo

Você nem sabe se o plano já estava bom o suficiente, aí paga pra descobrir

A execução, e a minha ressalva:

Em vez de trocar direto pro agente de execução, usei o comando de início de trabalho, seguindo a orientação da documentação

A ferramenta trocou sozinha pro agente de execução, criou a lista de tarefas e tocou o scaffolding (criar pastas, instalar dependências) em modo sequencial, sem eu delegar prompt por prompt

Massa de ver funcionando

Porém: demorou bastante

E isso me dá receio, porque eu não gosto de ferramenta lenta pra iterar, mesmo que ela prometa resultado grandioso

Eu perco mais tempo esperando, o resultado às vezes não vem do jeito que eu quero, e ainda tenho que modificar coisa depois

No fim abri a aplicação gerada e encontrei vários erros e problemas

O projeto ainda traz uma ferramentinha de debug que permite fazer comentários (parecida com recurso de design), mas eu não achei tão útil

No meu fluxo, prompt por prompt ou um loop rende resultado mais satisfatório e me deixa acompanhar o desenvolvimento sendo progressivo

Tem gente que prefere o modo automático, e tudo bem, só não quero vender o lado bonito e esconder o resto

No vídeo abaixo eu mostro tudo isso rodando: instalação, o plano sendo debatido pelos agentes e o app saindo com os problemas que saiu

Os atritos que fazem gente desistir na instalação:

Atrito 1: instalação global não funciona

Sintoma: você tenta instalar global como faz com qualquer CLI e não vai

Causa: npm install -g, bun add -g e bun install -g não são suportados, porque o omo é plugin e precisa resolver de onde o OpenCode ou o Codex carrega os plugins. Além disso o script de prepare exige o Bun

O que fazer: usar o comando da SUA edição, do jeito documentado

# Ultimate (plugin do OpenCode)
bunx oh-my-openagent install

# Light (plugin do Codex CLI)
npx lazycodex-ai install

Atrito 2: a tag @beta não é opcional

Sintoma: você tenta instalar a standalone e ela falha

Causa: npm i -g omo-ai sem @beta falha por design. E tem um detalhe pior: o pacote omo puro no npm é de outro autor e não tem relação nenhuma com o projeto

O que fazer: instalar com a tag, sempre

npm i -g omo-ai@beta

Tome cuidado aqui: instalar o pacote errado por causa de nome parecido é o tipo de erro que você leva meia hora pra perceber

Atrito 3: configuração quebrada depois do rename

Sintoma: você já usava a ferramenta com o nome antigo e depois da atualização a sua configuração parou de bater

Causa: o projeto era oh-my-opencode e virou oh-my-openagent, e a troca de nome do pacote quebrou configuração existente. Tem issue aberta sobre isso

O que fazer: se você é usuário antigo, trate o rename como migração de verdade, não como update de rotina

Como prevenir os três: instale primeiro num projeto de teste, rode o diagnóstico do próprio projeto antes de confiar no ambiente, e confirme a edição certa pro seu host antes de digitar qualquer comando

E lembra do que eu falei lá em cima: os agentes substituem os padrão do host

Se você não gostar, precisa desinstalar mesmo, senão eles continuam ali consumindo token a mais e executando processo que talvez você nem queira

Licença e conta de modelo: o custo que ninguém lê:

A licença não é MIT:

Essa aqui muda decisão de empresa

O Oh My OpenAgent usa a Sustainable Use License, e ela é bem específica: uso ou modificação apenas para fins internos do próprio negócio, uso pessoal ou não comercial

Redistribuição só gratuita e para fins não comerciais

E é proibido remover avisos de licença e de copyright

Ou seja: open source no código, mas com restrição de uso comercial e de redistribuição

Se o seu plano era empacotar isso dentro de um produto que você vende, para e lê a licença antes

O pano de fundo da conta de modelo:

O omo exige pelo menos um provedor de modelo configurado pra funcionar

E aqui entra um assunto que mexeu com todo mundo que usa harness de terceiro

A Anthropic proibiu que assinaturas Claude Pro e Max alimentassem agentes e harnesses de terceiros, com efeito em 4 de abril de 2026

Em 13 de maio de 2026 ela anunciou a volta do uso de terceiros por outro caminho: um crédito mensal separado de Agent SDK, de US$ 20 a US$ 200 conforme o plano, sem acúmulo, cobrado a preço de API, com início previsto pra 15 de junho de 2026

Aí, em 16 de junho de 2026, veio a pausa: a Anthropic comunicou que a mudança não entraria em vigor por ora, que o uso do Agent SDK continua funcionando com a assinatura como antes, sem crédito separado pra resgatar e sem alteração nos limites do plano, com promessa de aviso prévio antes de qualquer mudança futura

Moral da história: essa é uma área que já mudou três vezes em três meses

No vídeo eu estava usando um modelo da OpenAI porque tenho assinatura deles, e dá pra configurar qualquer modelo

Se você for plugar conta da Anthropic nesse tipo de ferramenta, vale ler as regras vigentes antes, não depois

Veredito: vale a pena para você?

Vale se:

Você é o perfil tokenmaxxer que a própria descrição do projeto cita: já opera OpenCode ou Codex CLI, já mexeu em hook e agent na unha, e quer estrutura pronta pra parar de remontar tudo

Sua base é grande o suficiente pra que orquestração (Sisyphus, Prometheus, Hephaestus) resolva um problema real, e não seja só enfeite

E você aceita projeto em movimento, incluindo rename que quebra configuração

Não vale se:

Você quer estabilidade de ferramenta madura: tem edição em beta, tem instalação com pegadinha e tem issue de configuração quebrada

Você depende de licença permissiva: a Sustainable Use License restringe uso comercial e redistribuição, ponto

Você não tem provedor de modelo configurado: esse é requisito mínimo, sem isso nem começa

E se você ainda está na fase de descobrir se dá pra criar projeto sem saber codar, esse harness só vai adicionar camada em cima de um problema que você ainda não tem

O que eu NÃO consigo afirmar:

Aqui eu prefiro ficar devendo a chutar

• Quantas estrelas o repositório tem hoje: as fontes divergem demais entre si, então não boto número por achismo
• Total de downloads do projeto
• Se hoje dá pra usar assinatura Claude Pro ou Max dentro do OpenCode com o omo
• Se existe alguma camada paga do próprio Oh My OpenAgent além do que a licença determina
• A lista fechada e atual de provedores e modelos suportados
• Requisitos mínimos de sistema e versões mínimas de OpenCode e Codex CLI
• Qualquer medição de desempenho ou economia de token comparando o omo com o uso puro do host

Se alguém te vender qualquer um desses números com ar de certeza, desconfia 😛

Conclusão:

Resumindo em uma frase: o Oh My OpenAgent vale a pena pra quem já mora dentro do OpenCode ou do Codex CLI e quer estrutura pronta, e não vale pra quem quer maturidade, licença permissiva ou está começando agora

O próximo passo é bem concreto

1. Identifique o seu host: OpenCode ou Codex CLI
2. Escolha a edição correspondente: Ultimate pro OpenCode, Light pro Codex CLI, Senpi/native se você topa beta standalone
3. Instale num projeto de teste, NUNCA na sua base principal
4. Rode o diagnóstico do projeto antes de confiar no ambiente
5. Leia o plano gerado inteiro antes de mandar executar

E se depois de tudo você não curtir, desinstala de verdade, porque os agentes ficam no lugar dos padrão e seguem consumindo token

Testa e me conta o que achou, tô curioso pra saber se o fluxo automático te rendeu mais que o prompt por prompt

até o próximo post! 😀