# oh-my-agent: Portable Multi-Agent Harness [![npm version](https://img.shields.io/npm/v/oh-my-agent?color=cb3837&logo=npm)](https://www.npmjs.com/package/oh-my-agent) [![npm downloads](https://img.shields.io/npm/dm/oh-my-agent?color=cb3837&logo=npm)](https://www.npmjs.com/package/oh-my-agent) [![GitHub stars](https://img.shields.io/github/stars/first-fluke/oh-my-agent?style=flat&logo=github)](https://github.com/first-fluke/oh-my-agent) [![License](https://img.shields.io/github/license/first-fluke/oh-my-agent)](https://github.com/first-fluke/oh-my-agent/blob/main/LICENSE) [![Last Updated](https://img.shields.io/github/last-commit/first-fluke/oh-my-agent?label=updated&logo=git)](https://github.com/first-fluke/oh-my-agent/commits/main) [English](../README.md) | [한국어](./README.ko.md) | [中文](./README.zh.md) | [Português](./README.pt.md) | [日本語](./README.ja.md) | [Français](./README.fr.md) | [Nederlands](./README.nl.md) | [Polski](./README.pl.md) | [Русский](./README.ru.md) | [Deutsch](./README.de.md) | [Tiếng Việt](./README.vi.md) | [ภาษาไทย](./README.th.md) ¿Alguna vez quisiste que tu asistente de IA tuviera compañeros de trabajo? Eso es lo que hace oh-my-agent. En vez de que una sola IA haga todo (y se pierda a mitad de camino), oh-my-agent reparte el trabajo entre **agentes especializados**: frontend, backend, architecture, QA, PM, DB, mobile, infra, debug, design y más. Cada uno conoce su dominio a fondo, tiene sus propias herramientas y checklists, y se mantiene en su carril. Funciona con todos los IDEs de IA principales: Antigravity, Claude Code, Codex, Cursor, Grok Build, Kimi Code, OpenCode, Pi, Qwen Code y más. ## Inicio Rápido ```bash # macOS / Linux — instala bun, uv y serena automáticamente si faltan curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash ``` ```powershell # Windows (PowerShell) — instala bun, uv y serena automáticamente si faltan irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex ``` ```bash # O manualmente (cualquier SO, requiere bun + uv + serena) bunx oh-my-agent@latest ``` ### Instalación vía Agent Package Manager

Agent Package Manager (APM) de Microsoft: distribución solo de skills. Click para expandir.

> No lo confundas con el APM (Application Performance Monitoring) de `oma-observability`. ```bash # Todos los skills, desplegados en cada runtime detectado # (.claude, .cursor, .codex, .opencode, .github, .agents) apm install first-fluke/oh-my-agent # Un solo skill apm install first-fluke/oh-my-agent/.agents/skills/oma-frontend ``` APM solo trae los skills. Para workflows, reglas, `oma-config.yaml`, hooks de detección de palabras clave y el CLI `oma agent:spawn`, usa `bunx oh-my-agent@latest`. Elige una sola forma de distribución por proyecto para no acabar con todo desincronizado.

Elige un preset y listo: | Preset | Lo Que Incluye | |--------|-------------| | ✨ All | Todos los agentes y 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 | ## Compatible con Todos los Agentes `oh-my-agent` mantiene `.agents/` como única fuente de verdad (SSOT) y la proyecta al diseño nativo de cada runtime. Así, todas las herramientas compatibles comparten los mismos skills, workflows y reglas.

Claude Code _{nativo + adaptador}	Codex CLI _{nativo + adaptador}	Antigravity _{SSOT nativo}	Cursor _{nativo + adaptador}	Qwen Code _{dispatch nativo}	Reasonix _{compatible nativamente}
Pi _{compatible nativamente}	OpenCode _{compatible nativamente}	Amp _{compatible nativamente}	GitHub Copilot _{skills por symlink}	Grok Build _{hooks nativos}	Kiro CLI _{hooks nativos + agentes}

_{& más}

## Tu Equipo de Agentes | Agente | Qué Hace | |-------|-------------| | **oma-academic-writer** | Redacta, revisa y audita prosa académica hasta alcanzar calidad de publicación | | **oma-architecture** | Evalúa trade-offs arquitectónicos y define límites de módulos con análisis ADR/ATAM/CBAM | | **oma-backend** | Construye y protege tus APIs en Python, Node.js o Rust | | **oma-brainstorm** | Explora ideas contigo antes de que te comprometas a construir | | **oma-coordination** | Guía la coordinación manual paso a paso de los agentes PM, frontend, backend, móvil y QA | | **oma-db** | Diseña tu esquema, migraciones, índices y almacenes vectoriales | | **oma-debug** | Encuentra la causa raíz, corrige el bug y escribe un test de regresión | | **oma-deepsec** | Escanea tu código en busca de vulnerabilidades y bloquea pull requests con riesgos | | **oma-design** | Construye sistemas de diseño con tokens, accesibilidad y layouts responsive | | **oma-dev-workflow** | Automatiza tu CI/CD, releases y tareas de monorepo | | **oma-docs** | Detecta referencias rotas en tu documentación y señala los docs afectados por cambios en el código | | **oma-frontend** | Construye tu UI con React/Next.js, TypeScript, Tailwind CSS v4 y shadcn/ui | | **oma-hwp** | Convierte archivos HWP, HWPX y HWPML a Markdown | | **oma-image** | Genera imágenes a través de varios proveedores de IA a la vez | | **oma-market** | Investiga tu mercado a partir de señales de comunidad y lo encuadra con SWOT, Porter's 5F y PESTEL | | **oma-mobile** | Construye apps móviles multiplataforma con Flutter | | **oma-observability** | Enruta el trabajo de observabilidad entre métricas, logs, trazas, SLOs y forense de incidentes | | **oma-orchestrator** | Ejecuta múltiples agentes en paralelo desde el CLI | | **oma-pdf** | Convierte archivos PDF a Markdown | | **oma-pm** | Planifica tareas, desglosa requisitos y define contratos de API | | **oma-qa** | Revisa tu código en busca de problemas de seguridad OWASP, rendimiento y accesibilidad | | **oma-recap** | Convierte tu historial de conversaciones en resúmenes de trabajo organizados por tema | | **oma-refactor** | Refactoriza el código sin cambiar su comportamiento usando hotspots, pruebas de caracterización y commits solo de refactor | | **oma-scholar** | Busca literatura académica y te ayuda a llevar a cabo revisiones por pares | | **oma-scm** | Gestiona tus ramas, fusiones, worktrees y Conventional Commits | | **oma-search** | Dirige cada consulta a la mejor fuente y puntúa qué tan confiable es el resultado | | **oma-skill-creator** | Escribe y audita nuevos skills OMA en formato SSL-lite | | **oma-slide** | Genera decks de presentaciones HTML distintivos y ricos en animaciones, y exporta a PDF/PNG/PPTX | | **oma-tf-infra** | Aprovisiona infraestructura multi-cloud con Terraform | | **oma-translator** | Traduce entre idiomas de forma que parezca escrito por un hablante nativo | | **oma-video** | Genera videos cortos, explicativos y demos mediante un pipeline de Remotion que funciona sin claves | | **oma-voice** | Genera voiceovers y transcribe audio en el dispositivo, sin necesidad de nube | ## Cómo Funciona Solo chatea. Describe lo que quieres y oh-my-agent se encarga de elegir los agentes adecuados. ``` Tú: "Construye una app de TODO con autenticación de usuarios" → PM planifica el trabajo → Backend construye la API de auth → Frontend construye la UI en React → DB diseña el esquema → QA revisa todo → Listo: código coordinado y revisado ``` O usa slash commands para flujos estructurados: | Paso | Comando | Qué Hace | |------|---------|-------------| | 0 | `/deepinit` | Mapea tu base de código existente en AGENTS.md, ARCHITECTURE.md y docs | | 1 | `/brainstorm` | Explora ideas contigo antes de que te comprometas a construir | | 2 | `/architecture` | Sopesa los trade-offs de tu diseño y traza límites de módulo limpios | | 2 | `/design` | Construye tu sistema de diseño con tokens, accesibilidad y layouts responsive | | 2 | `/plan` | Desglosa tu feature en tareas priorizadas | | 3 | `/work` | Construye tu feature paso a paso a través de varios agentes | | 3 | `/orchestrate` | Ejecuta varios agentes en paralelo para construir tu feature más rápido | | 3 | `/ultrawork` | Construye tu feature a través de cinco fases de calidad y once puertas de revisión | | 3 | `/ralph` | Repite `/ultrawork` hasta que un verificador independiente cumple todos los criterios | | 4 | `/review` | Revisa tu código en busca de problemas de seguridad, rendimiento y accesibilidad | | 4 | `/deepsec` | Ejecuta un escaneo de seguridad profundo y bloquea los pull requests arriesgados | | 5 | `/debug` | Encuentra la causa raíz, corrige el bug y escribe una prueba de regresión | | 5 | `/docs` | Revisa tus docs en busca de referencias rotas y parchea las que tocan tus cambios de código | | 6 | `/scm` | Gestiona tus ramas, merges y Conventional Commits | | - | `/schedule` | Programa un trabajo de agente para ejecutarse en un intervalo recurrente | **Auto-detección**: Ni siquiera necesitas slash commands. Palabras clave como "arquitectura", "plan", "review" y "debug" en tu mensaje (¡en 11 idiomas!) activan automáticamente el flujo correcto. ### Modelos por agente Cada agente puede apuntar a un modelo y `effort` propios desde `.agents/oma-config.yaml`. Runtime profiles disponibles: `antigravity`, `claude`, `codex`, `cursor`, `kiro`, `mixed`, `qwen`. Revisa la matriz de auth resuelta con `oma doctor --profile`. Guía completa: [web/docs/guide/per-agent-models.md](../web/docs/guide/per-agent-models.md). ## ¿Por Qué oh-my-agent? > [Leer más →](https://github.com/first-fluke/oh-my-agent/issues/155#issuecomment-4142133589) - **Portable**: `.agents/` viaja con tu proyecto, no queda atrapado en un IDE - **Basado en roles**: agentes modelados como un equipo de ingeniería real, no un montón de prompts - **Eficiente en tokens**: diseño de skills en dos capas ahorra ~75% de tokens - **Calidad primero**: Charter preflight, quality gates y flujos de revisión integrados: - `oma verify ` — 14 chequeos deterministas por tipo de agente (TypeScript strict, tests, raw SQL, secretos hardcoded, Flutter analyze, inline styles, scope violation, charter alignment …) - `session.quota_cap` — topes de tokens / spawn / por-vendor por sesión en `oma-config.yaml`; el Step 5 de `orchestrate` bloquea el siguiente spawn al excederse - workflow `ralph` — un JUDGE independiente re-verifica cada criterion en cada iteración para detectar regresiones silenciosas; cache para tests >30s - Exploration Loop — tras 2 reintentos, `orchestrate` lanza variantes de hipótesis en paralelo y conserva la de mayor puntaje - Auto-routing de monorepo — `detectWorkspace` lee pnpm / nx / turbo / lerna y enruta cada agente a su workspace - **Multi-vendor**: mezcla Antigravity, Claude, Codex, Cursor, Kiro y Qwen por tipo de agente - **Observable**: dashboards en terminal y web para monitoreo en tiempo real ## Arquitectura ```mermaid 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]) ``` ## Más Información - **[Documentación Detallada](./AGENTS_SPEC.md)**: spec técnico completo y arquitectura - **[Agentes Soportados](./SUPPORTED_AGENTS.md)**: matriz de soporte de agentes por IDE - **[Docs Web](https://first-fluke.github.io/oh-my-agent/)**: guías, tutoriales y referencia del CLI ## Sponsors Este proyecto se mantiene gracias a nuestros generosos sponsors. > **¿Te gusta este proyecto?** ¡Dale una estrella! > > ```bash > gh api --method PUT /user/starred/first-fluke/oh-my-agent > ``` > > Prueba nuestra plantilla starter optimizada: [fullstack-starter](https://github.com/first-fluke/fullstack-starter)

### 🚀 Champion ### 🛸 Booster ### ☕ Contributor [Hazte sponsor →](https://github.com/sponsors/first-fluke) Consulta [SPONSORS.md](../SPONSORS.md) para la lista completa de supporters. ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=first-fluke/oh-my-agent&type=date&legend=bottom-right)](https://www.star-history.com/#first-fluke/oh-my-agent&type=date&legend=bottom-right) ## Referencias - Liang, Q., Wang, H., Liang, Z., & Liu, Y. (2026). *From skill text to skill structure: The scheduling-structural-logical representation for agent skills* (Version 4) [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 - Yang, Y., Gong, Z., Huang, W., Yang, Q., Zhou, Z., Huang, Z., Li, Y., Gao, X., Dai, Q., Liu, B., Qiu, K., Yang, Y., Chen, D., Yang, X., & Luo, C. (2026). *SkillOpt: Executive strategy for self-evolving agent skills* [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.23904 - Huang, Z., Xu, J., Yang, Y., Gong, Z., Yang, Q., Tian, M., Wang, X., Lv, C., Gao, X., Dai, Q., Liu, B., Qiu, K., Yang, X., Chen, D., Zheng, X., & Luo, C. (2026). *From raw experience to skill consumption: A systematic study of model-generated agent skills* [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.23899 ## Licencia MIT