# Windows (PowerShell)
irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex

# Cualquier OS con bun instalado: la misma configuración, más el comando global `oma`
bun install --global oh-my-agent
oma

En Windows el instalador oculta Antigravity, Hermes y Kimi, y el wrapper de hooks es un script de bash. El MCP de navegador Aside, que viene por defecto, se instala con bash, así que desmárcalo si no tienes bash.

• Instala bun (obligatorio). Intenta instalar uv, Serena (uv tool install) y CUE (brew install cue o winget), y continúa con una advertencia si alguno falla.
• Preselecciona el MCP de navegador Aside en la configuración interactiva y solo lo instala con curl -fsSL https://releases.aside.com/install.sh | bash si lo mantienes seleccionado. Desmárcalo en el paso del MCP de navegador o cámbialo más tarde con oma update mcp.
• Usa AgentMemory para la memoria semántica, lo que ejecuta bun install -g @agentmemory/agentmemory y lo registra como servicio de inicio de sesión (launchd, unidad de usuario de systemd o tarea programada de Windows). Elige el proveedor none o define OMA_NO_AGENTMEMORY=1 para omitirlo.
• Pregunta antes de enlazar skills en las carpetas de vendors de tu directorio personal (Antigravity, Hermes, Kimi). En $HOME sin --global pide confirmación.
• Escribe algunos archivos fuera del proyecto sin preguntar: ~/.claude.json (marca el proyecto como espacio de trabajo de confianza de Claude Code), ~/.serena/ (contexto de OMA, tamaño mínimo de respuesta, registro del proyecto), ~/.cursor/cli-config.json (desactiva la atribución de commits de Cursor), ~/.grok/config.toml (telemetría) y ~/.gemini/antigravity-cli/ (HUD), cada uno solo para un vendor que hayas seleccionado.
• Escribe exclusiones de telemetría en los ajustes de los vendors (Claude DISABLE_TELEMETRY=1, que también desactiva Claude Code Remote Control; estadísticas de uso de Gemini, Qwen, Codex y Grok). Define telemetry: true para conservar los valores predeterminados de los vendors.
• Añade a .claude/settings.json los ajustes de Claude Code que no estén definidos, entre ellos skipDangerousModePermissionPrompt: true, effortLevel: high, cleanupPeriodDays: 180 y flags de env que desactivan la auto memory, el adaptive thinking, el reporte de errores y las instrucciones de git integradas. Los valores que ya hayas definido se conservan.
• Añade un trailer de coautoría: la atribución de commits de Claude Code pasa a ser Co-Authored-By: First Fluke <[email protected]> y las PR reciben una línea "Generated with oh-my-agent". Define scm.co_author.enabled: false para desactivarlo.
• Instala en .githooks/ una protección commit-msg que rechaza las direcciones Co-authored-by que no están en la lista, y configura git config --local core.hooksPath .githooks cuando no hay otros hooks activos. Define scm.co_author.enforce_hook: false para desactivarla.
• oma update actualiza la CLI de oma en segundo plano (auto_update_cli: false u OMA_SKIP_VERSION_CHECK=1 para detenerlo) y ejecuta uv tool upgrade serena-agent --prerelease=allow (serena.auto_update: false).
• Con Serena en el modo bridge predeterminado, la primera sesión de agente que inicia un servidor Serena compartido registra un temporizador de limpieza que detiene cada 5 minutos los servidores Serena compartidos inactivos (launchd dev.oma.serena-daemon-gc, temporizador de usuario de systemd oma-serena-daemon-gc.timer o tarea programada de Windows OMA Serena Daemon GC). Define serena.mode: stdio para omitir el servidor compartido y su temporizador. oma uninstall no elimina el temporizador.
• Las ejecuciones no interactivas (-y, OMA_YES=1, CI=true) usan el preset de skills All, model_preset: auto y Python como lenguaje de backend. No seleccionan ningún MCP de navegador (y omiten el script de instalación de Aside) salvo que mcp.devtools_browsers ya incluya uno.

De los presets con nombre, solo All incluye coordination, orchestration, docs, security, refactor, explanation, recap, video, slide y skill-creation (o elígelas en Custom). A Research y Content les faltan las skills en las que se apoyan /plan, /review, /debug, /architecture y /brainstorm. Consulta Workflows que necesitan skills fuera de un preset.

Al ingeniero de infraestructura (tf-infra-engineer) se le indica que pregunte antes de cualquier apply o destroy destructivo o en producción. Las skills restantes (brainstorm, security, scm, dev-workflow, observability, explanation, recap, translation, coordination, orchestration, skill-creation, contenido y medios) no tienen un rol dedicado. Tu agente las carga por sí mismo, y para la mayoría el skill injector sugiere la adecuada a partir de tu prompt.

oma verify triggers evalúa la precisión de activación con un corpus etiquetado de 212 prompts en inglés y coreano. CI falla si false-fire supera el 10 % o missed-fire supera el 20 %. En la última medición, los valores fueron 0 % de missed-fire y 5,3 % de false-fire. Referencia completa: Workflows.

/stack-set lee tus manifiestos y escribe referencias específicas del stack para las skills de backend, frontend y móvil. En un monorepo, a los ingenieros de frontend, backend y móvil se les dirige a su workspace (pnpm, workspaces de npm/yarn/bun, lerna, nx, turbo, mise.toml).

Estos pipelines informan de que falta una fuente o una clave de vendor en lugar de devolver en silencio un resultado más pobre.

oma hook probe comprueba que los prompt hooks de oma aceptan la entrada de hooks de cada runtime (no lanza el runtime). Qué hooks conecta cada runtime se detalla en Diferencias entre hosts.

• oma agent spawn <role> "<task>" <sid> ejecuta un rol en Antigravity, Claude Code, Codex, Cursor, Grok, Kimi Code, Kiro, OpenCode, pi o Qwen Code, con --isolation worktree y --fallback-vendors. oma agent parallel ejecuta varios a la vez. Estos 10 destinos de dispatch son un subconjunto de las 14 integraciones del instalador.
• oma state list --all-projects y oma state get <sid>: las sesiones y cada evento registrado.
• oma dashboard terminal / oma dashboard web: estado de los agentes en vivo (el dashboard web solo escucha en 127.0.0.1). Guía del dashboard.
• oma stats get (métricas de productividad), oma retro (una retrospectiva de git), oma recap --window 7d (lo que hiciste en tus herramientas de IA).
• oma visualize --affected <paths>: qué skills, workflows, agentes y comprobaciones dependen de los archivos de .agents/ que cambiaste.

Serena proporciona navegación de código y diagnósticos basados en LSP, incluida la retroalimentación sobre ediciones nativas cuando es compatible. La selección del proveedor es independiente del runtime del agente; las capacidades varían según el proveedor y el host.

Los agentes se coordinan mediante archivos simples en .agents/state/, sin ningún servicio externo. /tools activa o desactiva herramientas MCP en lenguaje natural. Detalles: Proveedores de Capacidades.

• oma skill eval mide la mejora que aporta una skill frente a una baseline en tareas held-out. oma skill optimize propone ediciones que la aumentan, y --apply las conserva (guía de skill-eval).
• oma harness evolution enable --max-dispatches <n> programa un ciclo nocturno que convierte las ejecuciones fallidas en fixtures de regresión y aplica como overlays del proyecto las mejoras de skills que superan la evaluación. Añade --mode propose para solo registrarlas.
• oma emit exporta el código fuente de .agents/ como un paquete de Agent Skills, un paquete de Agent Plugins, un marketplace de plugins de Claude Code o AGENTS.md.

• Un único .agents/oma-config.yaml, propiedad del usuario, sobrevive a las actualizaciones (solo oma update --force lo restablece); encima pueden ir overlays privados .local.yaml o .local.cue. language define el idioma de respuesta.
• 13 reglas de proyecto (backend, commit, database, debug, design y más) se cargan como reglas nativas en Claude Code y Cursor, y se indexan en el bloque gestionado de AGENTS.md que se escribe para Codex, Qwen Code y Pi.
• Las actualizaciones guardan copias de seguridad de la configuración y de las migraciones en .agents/backup/; las skills y los workflows incluidos se sustituyen en su sitio, así que mantén los cambios locales fuera de ellos. oma uninstall --dry-run muestra lo que se eliminaría. first-fluke/oma-update-action@v1 ejecuta oma update en CI y abre un PR.

nativo = oma escribe los propios archivos de configuración del runtime; adaptador = oma además añade shims de hooks o de agentes. Amp lee .agents/skills/ por sí mismo y no es un destino del instalador.

Claude Code nativo + adaptador	Codex CLI nativo + adaptador	Antigravity SSOT nativo	Cursor nativo + adaptador	Qwen Code dispatch nativo	DeepSeek Harness Cordis plugin
Pi compatible nativamente	OpenCode compatible nativamente	Amp lee .agents/skills	GitHub Copilot skills por symlink	Grok Build hooks nativos	Kiro CLI hooks nativos + agentes

_{& más}

model_preset en .agents/oma-config.yaml elige qué modelo usa cada rol de agente. El valor por defecto, auto, sigue la configuración de agentes y modelos del propio runtime en ejecución.

language: en
model_preset: auto   # auto | free | antigravity | claude | codex | cursor | kiro | mixed | qwen | <custom_presets key>

# Optional per-agent overrides; they win over the preset
agents:
  backend: { model: openai/gpt-6.1-terra, effort: high }

• mixed usa Claude para el orquestador, arquitectura, QA, PM y docs, y Codex gpt-6.1-terra para los roles de implementación, así que necesita tanto Claude Code como Codex CLI.
• free pasa por un gateway de FreeLLMAPI y necesita FREELLM_API_KEY y un servidor en ejecución.
• kiro no aparece en el menú del instalador; defínelo en el archivo de configuración.
• oma doctor --profile imprime el modelo resuelto para cada rol.
• Guía completa: Modelos por agente

Límites del Stop gate:

• El Stop gate solo se aplica a los workflows persistentes (/orchestrate, /work, /ultrawork, /ralph). Sin oma goal set --gate, solo vuelve a pedirle al agente que continúe. /ultrawork le indica al agente que defina un gate cuando el proyecto tiene una comprobación barata, pero nada lo impone. Ejecuta oma goal set --gate test tú mismo si quieres asegurarte; los demás workflows persistentes nunca definen uno.
• Solo se aceptan las palabras clave typecheck, test y lint, y ejecutan el script de package.json con ese nombre. Sin package.json, o sin un script con ese nombre, el gate no se ejecuta. Los proyectos que no son JS necesitan un script wrapper en un package.json.
• El bloqueo se libera y se registra como fallido tras 5 refuerzos, 2 horas o el agotamiento de --budget-minutes.
• Presupuestos: session.quota_cap limita tokens, número de spawns y tokens por vendor; el orquestador rechaza el siguiente spawn cuando se excede alguna dimensión.

Gate de artefactos. Si falta un artefacto, la fase no queda acreditada. La comprobación de refactor también pasa como skip-recorded cuando el log de la sesión registra un motivo para omitir REFINE.

Juez basado en prompt. El prompt de /ralph indica al orquestador que lance al juez como agente independiente con contexto nuevo y le proporcione solo los criterios. El juez debe volver a comprobar todos los criterios en cada iteración, incluidos los que ya pasaron, porque corregir un criterio puede hacer que otro vuelva a fallar. oma ralph verify aplica el gate solo a los artefactos de EXEC; no comprueba si el juez llegó a lanzarse. Si un runtime no puede lanzar subagentes, debe juzgar inline y registrar ralph.judge-inline-fallback. /ralph se detiene tras 5 iteraciones con un informe parcial.

Event log. Encuentra la sesión con oma state list y léela con oma state get <sid>. Cada evento lleva el sello del vendor y del id de sesión del runtime. La ubicación del archivo depende de OMA_HOME, OMA_STATE_HOME, OMA_PROFILE y de las antiguas carpetas de sesión dentro del proyecto, así que no la dejes fija en el código.

Chequeos por agente. Tipos: backend, frontend, mobile, qa, debug, pm. El comando sale con código 1 cuando falla algún chequeo; TODO/FIXME Comments e Inline Styles solo avisan.

• backend: <Language> Syntax, SQL Injection (patrones de SQL sin procesar) y <Language> Tests, a partir de los comandos de stack/stack.yaml. Sin ese archivo (genéralo con /stack-set) se omiten.
• frontend: los comandos de sintaxis y de tests de stack/stack.yaml (en oma-frontend, o en angular-developer si esa skill está instalada), o TypeScript (tsc --noEmit) y Frontend Tests (Vitest). Inline Styles y Any Types se ejecutan siempre.
• mobile: los comandos de sintaxis y de tests de stack/stack.yaml, o Flutter/Dart Analysis y Flutter Tests.
• debug: Python Tests (pytest a través de uv) o Frontend Tests (Vitest).
• pm: PM Plan (el archivo del plan es JSON válido).
• qa: sin chequeos mecánicos.

flowchart TD
    S[Agent tries to stop] --> P{Persistent workflow active?}
    P -- no --> A[Stop allowed]
    P -- yes --> D{User or agent said workflow done?}
    D -- yes --> A
    D -- no --> R{Budget spent, state older than 2 h, or 5 blocks reached?}
    R -- yes --> F[Stop allowed, logged as gate.failed]
    R -- no --> G{Gate set and package.json script exists?}
    G -- no --> B1[Blocked: workflow still active]
    G -- yes --> X{Script exits 0 within 25 s?}
    X -- yes --> OK[Stop allowed, logged as gate.passed]
    X -- no --> B2[Blocked with output tail, logged as gate.failed]

No. Consulta Presets de skills; All es la opción segura por defecto.

oma doctor muestra las skills instaladas y avisa cuando los hooks no encuentran oma. Durante un workflow persistente, oma state list muestra la sesión activa y oma state get <sid> sus eventos de gate.

Normalmente, sí. Las skills solo se cargan cuando una tarea las necesita, pero los workflows multiagente y las revisiones con contexto nuevo gastan más. En el benchmark de un solo prompt, oma costó 1,7 veces lo que Claude Code sin más.

Di "workflow done" (o "workflow complete" / "workflow finished", o su equivalente en los demás idiomas soportados), o borra .agents/state/<workflow>-state-<sid>.json. Si no haces ninguna de las dos cosas, se libera solo tras 5 bloqueos o 2 horas.

oma update actualiza skills, workflows y hooks y conserva tu configuración (--with-new-skills añade las skills nuevas de la release; oma update mcp vuelve a elegir el MCP de navegador). oma uninstall --dry-run muestra lo que se eliminaría; oma uninstall lo elimina y conserva oma-config.yaml, mcp.json y las skills que escribiste tú. Más soluciones: Solución de problemas.

La planificación y la elección del siguiente paso quedan en manos del modelo de tu agente; oma no tiene un grafo de workflow fijo. Lo que oma impone fuera del modelo: guardarraíles de herramientas (los guards de secretos y de búsqueda), presupuestos, límites de reintentos y de parada, un event log y, cuando defines un gate, una parada que espera a que pasen tus propias comprobaciones.

• Li, X., Liu, Y., Chen, W., You, B., Di, Z., He, Y., Zheng, S., Choe, K. W., Sun, J., Wang, S., Tao, C., Li, B., Zhao, X., Geng, H., Wu, X., Zhou, J., Chen, X., Xing, H., Li, Y., … Song, D. (2026). SkillsBench: Benchmarking how well agent skills work across diverse tasks (Version 4) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2602.12670
• Yu, G., & Wang, X. (2026). Knows: Agent-native structured research representations (Version 1) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2604.17309
• 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
• Tang, L., Rashtchian, C., Ferng, C.-S., Tomkins, A., Juan, D.-C., & Vu, T. (2026). WikiSkill: Compiling agent experience into persistent knowledge for skill evolution [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2608.27454
• 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
• Hong, D. B., Imani, A., & Ahmed, I. (2026). From anatomy to smells: An empirical study of SKILL.md in agent skills (Version 2) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2607.01456