oh-my-agent: Portable Multi-Agent Harness

Ja quis que seu assistente de IA tivesse colegas de trabalho? E isso que o oh-my-agent faz.

Em vez de uma unica IA fazendo tudo (e se perdendo no meio do caminho), o oh-my-agent divide o trabalho entre agentes especializados: frontend, backend, architecture, QA, PM, DB, mobile, infra, debug, design e mais. Cada um conhece bem o seu dominio, tem suas proprias ferramentas e checklists, e nao sai da sua area.

Funciona com todas as principais IDEs de IA: Antigravity, Claude Code, Cursor, Gemini CLI, Codex CLI, OpenCode e mais.

Inicio Rapido

# macOS / Linux — instala bun, uv & serena automaticamente se nao tiver
curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash

# Windows (PowerShell) — instala bun, uv & serena automaticamente se nao tiver
irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex

# Ou manualmente (qualquer SO, requer bun + uv + serena)
bunx oh-my-agent@latest

Instalacao via Agent Package Manager

Agent Package Manager (APM) da Microsoft: distribuicao so com skills. Clique para expandir.

Nao confunda com o APM (Application Performance Monitoring) do oma-observability.

# Todos os skills, instalados em cada runtime detectado
# (.claude, .cursor, .codex, .opencode, .github, .agents)
apm install first-fluke/oh-my-agent

# Um unico skill
apm install first-fluke/oh-my-agent/.agents/skills/oma-frontend

O APM so entrega os skills. Para workflows, regras, oma-config.yaml, hooks de deteccao de palavras-chave e a CLI oma agent:spawn, use bunx oh-my-agent@latest. Escolha so um modo de distribuicao por projeto, senao acaba dando ruim.

Escolha um preset e pronto:

Preset	O Que Voce Ganha
✨ All	Todos os agentes e skills
🌐 Fullstack	architecture + frontend + backend + db + pm + qa + debug + brainstorm + scm
🎨 Frontend	architecture + frontend + pm + qa + debug + brainstorm + scm
⚙️ Backend	architecture + backend + db + pm + qa + debug + brainstorm + scm
📱 Mobile	architecture + mobile + pm + qa + debug + brainstorm + scm
🚀 DevOps	architecture + tf-infra + dev-workflow + pm + qa + debug + brainstorm + scm

Funciona com Todos os Agentes

O oh-my-agent mantém .agents/ como única fonte de verdade (SSOT) e o projeta no layout nativo de cada runtime. Assim, todas as ferramentas suportadas compartilham os mesmos skills, workflows e regras.

Claude Code _{nativo + adaptador}	Codex CLI _{nativo + adaptador}	Gemini CLI _{nativo + adaptador}	Cursor _{nativo + adaptador}	Qwen Code _{dispatch nativo}	Grok _{native hooks + agents}
Antigravity _{SSOT nativo}	OpenCode _{compatível nativamente}	Amp _{compatível nativamente}	GitHub Copilot _{skills via symlink}	& mais _{matriz de suporte →}

Seu Time de Agentes

Agente	O Que Faz
oma-academic-writer	Redige, revisa e audita prosa academica ate o nivel de publicacao
oma-architecture	Avalia trade-offs de arquitetura e define limites de modulos com analise ADR/ATAM/CBAM
oma-backend	Constroi e protege suas APIs em Python, Node.js ou Rust
oma-brainstorm	Explora ideias com voce antes de voce se comprometer a construir
oma-db	Projeta seu schema, migrations, indexes e vector stores
oma-debug	Encontra a causa raiz, corrige o bug e escreve um teste de regressao
oma-deepsec	Varre seu codigo em busca de falhas de seguranca e bloqueia pull requests arriscados
oma-design	Constroi design systems com tokens, acessibilidade e layouts responsivos
oma-dev-workflow	Automatiza seu CI/CD, releases e tarefas de monorepo
oma-docs	Verifica referencias quebradas na documentacao e sinaliza o que uma mudanca de codigo afetou
oma-frontend	Constroi sua UI com React/Next.js, TypeScript, Tailwind CSS v4 e shadcn/ui
oma-hwp	Converte arquivos HWP, HWPX e HWPML para Markdown
oma-image	Gera imagens por varios provedores de IA ao mesmo tempo
oma-market	Pesquisa seu mercado a partir de sinais de comunidade e estrutura os resultados com SWOT, Porter's 5F e PESTEL
oma-mobile	Constroi apps mobile cross-platform com Flutter
oma-observability	Roteia trabalho de observabilidade entre metricas, logs, traces, SLOs e forense de incidentes
oma-orchestrator	Executa multiplos agentes em paralelo via CLI
oma-pdf	Converte arquivos PDF para Markdown
oma-pm	Planeja tarefas, detalha requisitos e define contratos de API
oma-qa	Revisa seu codigo em busca de problemas de seguranca OWASP, performance e acessibilidade
oma-recap	Resume seu historico de conversas em resumos tematicos de trabalho
oma-scholar	Busca literatura academica e ajuda voce a conduzir revisoes por pares
oma-scm	Gerencia seus branches, merges, worktrees e Conventional Commits
oma-search	Roteia cada consulta para a melhor fonte e pontua o nivel de confianca do resultado
oma-skill-creator	Escreve e audita novos skills OMA no formato SSL-lite
oma-slide	Gera decks de apresentacao HTML distintos e ricos em animacoes e exporta para PDF/PNG/PPTX
oma-tf-infra	Provisiona infraestrutura multi-cloud com Terraform
oma-translator	Traduz entre idiomas de forma que parece escrito por um falante nativo
oma-voice	Gera voiceovers e transcreve audio localmente, sem precisar de nuvem

Como Funciona

So conversar. Descreva o que voce quer e o oh-my-agent descobre quais agentes usar.

Voce: "Cria um app de TODO com autenticacao de usuario"
→ PM planeja o trabalho
→ Backend constroi a API de auth
→ Frontend constroi a UI em React
→ DB desenha o schema
→ QA revisa tudo
→ Pronto: codigo coordenado e revisado

Ou use slash commands para workflows estruturados:

Etapa	Comando	O Que Faz
1	`/brainstorm`	Ideacao livre
2	`/architecture`	Revisao de arquitetura, trade-offs, analise estilo ADR/ATAM/CBAM
2	`/design`	Workflow de design system em 7 fases
2	`/plan`	PM detalha sua feature em tarefas
3	`/work`	Execucao multi-agente passo a passo
3	`/orchestrate`	Spawn automatico e paralelo de agentes
3	`/ultrawork`	Workflow de qualidade em 5 fases com 11 gates de revisao
4	`/review`	Auditoria de seguranca + performance + acessibilidade
4	`/deepsec`	Varredura de seguranca profunda por agente
5	`/debug`	Debugging estruturado de causa raiz
5	`/docs`	Verificação e sincronização de drift de documentação via `oma-docs`
6	`/scm`	Workflow SCM e Git com suporte a Conventional Commits

Auto-deteccao: Voce nem precisa dos slash commands. Palavras como "arquitetura", "plan", "review" e "debug" na sua mensagem (em 11 idiomas!) ativam automaticamente o workflow certo.

CLI

# Instalar globalmente
bun install --global oh-my-agent   # ou: brew install oh-my-agent

# Usar em qualquer lugar
oma agent:parallel -i backend:"Auth API" frontend:"Login form"
oma agent:spawn backend "Build auth API" session-01
oma dashboard               # Monitoramento em tempo real
oma doctor                  # Health check
oma image generate "cat"    # Geração de imagens IA multi-fornecedor
oma link                    # Regenera .claude/.codex/.gemini/etc. a partir de .agents/
oma model:check             # Detecta drift entre modelos registrados e listas de vendor ao vivo
oma recap --window 1d       # Recap de histórico de conversa entre ferramentas
oma retro 7d --compare      # Retrospectiva de engenharia com métricas + tendências
oma search fetch <url>      # Busca mecânica com estratégias auto-escaláveis

A seleção de modelo segue duas camadas:

Dispatch nativo de mesmo vendor usa a definição de agente gerada em .claude/agents/, .codex/agents/ ou .gemini/agents/.
Dispatch cross-vendor ou fallback via CLI usa os padrões de vendor em .agents/skills/oma-orchestrator/config/cli-config.yaml.

modelos por agente: cada agente pode apontar para seu próprio modelo e effort a partir de .agents/oma-config.yaml. Os runtime profiles disponíveis: antigravity, claude, codex, cursor, grok, mixed, qwen. Confira a matriz de auth resolvida com oma doctor --profile. Guia completo: web/docs/guide/per-agent-models.md.

Por Que oh-my-agent?

Saiba mais →

Portavel: .agents/ viaja com seu projeto, sem ficar preso a uma IDE
Baseado em papeis: agentes modelados como um time de engenharia real, nao um amontoado de prompts
Eficiente em tokens: design de skills em duas camadas economiza ~75% de tokens
Qualidade primeiro: Charter preflight, quality gates e workflows de revisao integrados:
- oma verify <agent> — 14 checagens deterministicas por tipo de agente (TypeScript strict, tests, raw SQL, segredos hardcoded, Flutter analyze, inline styles, scope violation, charter alignment …)
- session.quota_cap — limites de tokens / spawn / por-vendor por sessao em oma-config.yaml; o Step 5 do orchestrate bloqueia o proximo spawn ao exceder
- workflow ralph — JUDGE independente reverifica cada criterion a cada iteracao para detectar regressoes silenciosas; cache para tests >30s
- Exploration Loop — apos 2 retries, orchestrate faz spawn paralelo de variantes de hipotese e mantem a de maior pontuacao
- Auto-roteamento de monorepo — detectWorkspace le pnpm / nx / turbo / lerna e roteia cada agente para seu workspace
Multi-vendor: misture Claude, Codex, Cursor e Qwen por tipo de agente
Observavel: dashboards no terminal e na web para monitoramento em tempo real

Arquitetura

flowchart TD
    subgraph Workflows["Workflows"]
        direction TB
        W0["/brainstorm"]
        W1["/work"]
        W1b["/ultrawork"]
        W2["/orchestrate"]
        W3["/architecture"]
        W4["/plan"]
        W5["/review"]
        W6["/debug"]
        W7["/deepinit"]
        W8["/design"]
    end

    subgraph Orchestration["Orchestration"]
        direction TB
        PM[oma-pm]
        ORC[oma-orchestrator]
    end

    subgraph Domain["Domain Agents"]
        direction TB
        ARC[oma-architecture]
        FE[oma-frontend]
        BE[oma-backend]
        DB[oma-db]
        MB[oma-mobile]
        DES[oma-design]
        TF[oma-tf-infra]
    end

    subgraph Quality["Quality"]
        direction TB
        QA[oma-qa]
        DBG[oma-debug]
    end

    Workflows --> Orchestration
    Orchestration --> Domain
    Domain --> Quality
    Quality --> SCM([oma-scm])

Saiba Mais

Documentacao Detalhada: spec tecnica completa e arquitetura
Agentes Suportados: matriz de suporte de agentes por IDE
Docs Web: guias, tutoriais e referencia da CLI

Star History

Referências

Liang, Q., Wang, H., Liang, Z., & Liu, Y. (2026). From skill text to skill structure: The scheduling-structural-logical representation for agent skills (Version 2) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2604.24026
Chen, C., Yu, Q., Gu, Y., Huang, Z., Li, H., Liu, H., Liu, S., Liu, J., Peng, D., Wang, J., Yan, Z., Meng, F., Qin, E., Che, C., & Hu, M. (2026). The scaling laws of skills in LLM agent systems (Version 1) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.16508

Licenca

MIT

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

oh-my-agent: Portable Multi-Agent Harness

Inicio Rapido

Instalacao via Agent Package Manager

Funciona com Todos os Agentes

Seu Time de Agentes

Como Funciona

CLI

Por Que oh-my-agent?

Arquitetura

Saiba Mais

Sponsors

🚀 Champion

🛸 Booster

☕ Contributor

Star History

Referências

Licenca

Uh oh!

FilesExpand file tree

README.pt.md

Latest commit

History

README.pt.md

File metadata and controls

oh-my-agent: Portable Multi-Agent Harness

Inicio Rapido

Instalacao via Agent Package Manager

Funciona com Todos os Agentes

Seu Time de Agentes

Como Funciona

CLI

Por Que oh-my-agent?

Arquitetura

Saiba Mais

Sponsors

🚀 Champion

🛸 Booster

☕ Contributor

Star History

Referências

Licenca