oh-my-claudecode: orquestación multiagente de equipos para Claude Code, instalada como plugin oficial
Yeachan-Heo/oh-my-claudecode · 39.354★ · 3.514 forks
oh-my-claudecode (OMC) instala una capa de orquestación «de equipos primero» encima de Claude Code: convierte una sola sesión del agente en un equipo de agentes especializados que planifica, ejecuta, verifica y corrige, sin que el usuario tenga que aprender comandos nuevos. Se instala desde el propio sistema de plugins de Claude Code o desde npm, tiene licencia MIT y, a 22 de agosto de 2026, acumula más de 38 000 estrellas.
Origen
El repositorio fue creado el 9 de enero de 2026 por Yeachan Heo (cuenta Yeachan-Heo), un trader algorítmico y líder de la comunidad cuantificadora coreana Quant.start(), vinculado a Layoff-Labs y radicado en Seúl. OMC es, con diferencia, su repositorio más grande: encabeza una lista de 67 repositorios públicos con 4 731 seguidores.
La fecha de creación importa por el contexto: ese mismo 9 de enero de 2026 se discutió en Hacker News que Anthropic bloqueaba el uso de suscripciones de Claude Code por parte de clientes de terceros (hilo con 625 puntos). OMC nace justo después de esa restricción, apoyándose explícitamente en oh-my-opencode como inspiración citada en el README. El sitio web compañero del autor se autodescribe con la frase «They banned us. We came back» («Nos prohibieron. Volvimos»). La lectura consistente de las fuentes es que OMC reencuadra «dentro del sistema oficial» una tradición de orquestación que antes vivía en clientes de terceros: en vez de rodear a Claude Code, se instala encima de él mediante su propio sistema de plugins.
Un detalle que el README aclara: el proyecto se marca oh-my-claudecode (repositorio, plugin y comandos), pero el paquete de npm se publica como oh-my-claude-sisyphus; instalar o actualizar por npm exige usar ese segundo nombre.
Filosofía y principios
El lema del README es «Multi-agent orchestration for Claude Code. Zero learning curve» y «Don’t learn Claude Code. Just use OMC». Los principios verificables en la documentación:
- Cero configuración: valores inteligentes por defecto; el usuario describe en lenguaje natural lo que quiere.
- Orquestación «de equipos primero»: el modo
Teames la superficie canónica de multiagente; la palabra clave legadaswarmfue eliminada a partir de v4.1.7. - Paralelización automática: las tareas complejas se reparten entre agentes especializados.
- Ejecución persistente: no «renuncia» hasta que la tarea está verificada como completa (modo Ralph).
- Optimización de coste: enrutamiento inteligente de modelos (Haiku para tareas simples, Opus para razonamiento complejo); el README afirma un ahorro del 30–50 % en tokens.
- Aprendizaje de la experiencia: extrae patrones de resolución de problemas y los reutiliza como habilidades.
- Visibilidad en tiempo real: una línea de estado (HUD) muestra qué ocurre por debajo.
La idea central frente a la competencia: no es un solo agente que llama subagentes «como herramientas», sino una etapa de pipeline donde cada rol (planificador, crítico, ejecutor, verificador) es un agente con su propio contexto que se valida mutuamente.
Cómo funciona
OMC expone dos superficies: comandos de CLI en terminal (omc ...), tras instalar el paquete npm/runtime, y habilidades «in-session» (/...), dentro de una sesión de Claude Code tras el flujo de plugin/setup.
El pipeline canónico de Team es:
team-plan → team-prd → team-exec → team-verify → team-fix (bucle)
El modo Autopilot es una pipeline autónoma de cinco etapas: (1) Expansión — los agentes analyst y architect aclaran requisitos y producen una especificación; (2) Planificación — planner crea el plan y critic lo revisa; (3) Ejecución — executor escribe el código, en paralelo si hace falta; (4) QA — verifica build y pruebas, corrige y re-verifica; (5) Validación — especialistas revisan funcionalidad, seguridad y calidad.
Los modos de orquestación documentados son: Team (canónico), omc team (CLI) (workers tmux reales de claude/codex/gemini/antigravity/grok/cursor-agent), ccg (asesores de tres modelos), Autopilot (un agente líder), Ultrawork (máxima paralelización no-equipo), Ralph (persistente con bucles verificar/corregir), UltraQA, Pipeline (secuencial) y Ultrapilot (legado).
El proyecto documenta 19 agentes especializados en el README, mientras que docs/REFERENCE.md los cuenta como «29 en total» al incluir variantes por nivel (LOW/Haiku, MEDIUM/Sonnet, HIGH/Opus). Las habilidades se cuentan como 38 en REFERENCE.md.
Las palabras mágicas disparan habilidades sin comando explícito: ralph, ulw (ultrawork), ralplan, deepsearch, ultrathink, y stopomc/cancelomc para detener. El README también documenta /deep-interview (preguntas socráticas antes de escribir código), skills personalizadas en .omc/skills/ y un sistema de hooks por evento de ciclo de vida.
El ecosistema
El autor mantiene una familia «oh-my-*» y tooling adyacente. Cifras de la API de GitHub, 22 de agosto de 2026: Yeachan-Heo/oh-my-codex — la misma orquestación para OpenAI Codex CLI, 32 800 estrellas; Yeachan-Heo/gajae-code — «Gajae Code MVP», 2 551 estrellas; Yeachan-Heo/clawhip — router de notificaciones, 929 estrellas; Yeachan-Heo/claw-code — 39 estrellas; Yeachan-Heo/rusty-claude-code — reimplementación en Rust, 26 estrellas.
La búsqueda de repositorios «oh-my-claudecode» devuelve unos 91 resultados. Los no-espejo más notables: witt3rd/oh-my-hermes — «Oh My Hermes (OMH)», habilidades de orquestación multiagente para Hermes Agent, «Inspired by oh-my-…»; 273 estrellas, el puerto no oficial más visible fuera de Claude/Codex; MeroZemory/oh-my-droid — orquestación para Factory AI Droid CLI, 28 estrellas; dasomel/oh-my-cursor — reglas de orquestación para Cursor, 2 estrellas.
El README, en su pie, cita cinco inspiraciones: code-yeongyu/oh-my-opencode (hoy code-yeongyu/oh-my-openagent, 68 246 estrellas), affaan-m/everything-claude-code (hoy affaan-m/ECC, 242 166 estrellas), obra/superpowers (276 177 estrellas), jarrodwatts/claude-hud (27 560 estrellas) y Q00/ouroboros (5 623 estrellas). Son inspiraciones del autor, no dependencias técnicas ni afiliaciones.
Estado oficial / semioficial
OMC no tiene un respaldo de un vendor en las fuentes recuperadas: no hay ninguna designación de «estándar» por parte de Anthropic ni de otro proveedor. Su estatus real es:
- Plugin distribuido a través del sistema de plugins de Claude Code, instalado desde un marketplace auto-alojado en el propio repositorio. Es instalable desde el catálogo de plugins del CLI oficial de Anthropic, pero el catálogo lo mantiene el propio proyecto, no Anthropic.
- Paquete publicado en npm (
oh-my-claude-sisyphus), con actualizaciones automáticas cada 24 h. - Estándar de facto dentro de un nicho concreto: la orquestación multiagente «de equipos» para Claude Code. La rapidez con que creció (más de 38 000 estrellas en ~7 meses) y la aparición de puertos a Hermes, Droid, Cursor y Warp lo sitúan como referencia de facto de ese patrón, aunque sin ninguna certificación formal.
En la práctica, «oficial» aquí significa instalable desde el plugin system de Claude Code, no endorsado por Anthropic.
Números del repo
Medición: 22 de agosto de 2026, 23:59 UTC, API de GitHub.
| Métrica | Valor |
|---|---|
| Estrellas | 38 737 |
| Bifurcaciones | 3 476 |
| Suscriptores (watchers reales) | 128 |
| Incidencias abiertas | 7 |
| Commits (última página de paginación) | ≈ 3 559 |
| Lenguaje principal | TypeScript |
| Licencia | MIT |
| Creación | 9 de enero de 2026 |
| Último push | 22 de agosto de 2026 |
| Última publicación | v4.15.10, 10 de agosto de 2026 |
| Descargas npm (último mes) | 23 867 |
watchers_count replica las estrellas, por lo que se informa por separado subscribers_count (128) como espectadores reales. Principales contribuidores: Yeachan-Heo (2 619), shaun0927 (71), devseunggwan (22), hakilee (20), junhoyeo (15).
Guía rápida de uso
Instalación y primer arranque
Prerrequisitos: CLI de Claude Code instalado y una suscripción Claude Max/Pro o una clave de API de Anthropic. Para los workers de equipo también hace falta tmux (macOS/Linux) o psmux (Windows nativo).
Vía marketplace/plugin (recomendada; los comandos van uno a la vez):
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode/plugin install oh-my-claudecodeVía npm:
npm i -g oh-my-claude-sisyphus@latestLuego el setup: /setup, /omc-setup, o desde el terminal omc setup.
Flujos de trabajo habituales
- Construir de punta a punta:
/autopilot "build a REST API for managing tasks"; el pipeline de 5 etapas se ejecuta solo. - Requisito vago:
/deep-interview "I want to build a task management app"lanza el interrogatorio socrático antes de escribir código. - Equipo en paralelo real:
omc team 2:codex "review auth module for security issues"abre dos paneles tmux con Codex. - Asesoría de otro modelo:
omc ask codex "review this patch"corre el CLI local del proveedor y guarda el artefacto en.omc/artifacts/ask/.
Configuración esencial
| Archivo / ajuste | Qué es |
|---|---|
~/.config/claude-omc/config.jsonc | Configuración de usuario (global), formato JSONC |
.claude/omc.jsonc | Configuración de proyecto; prioridad sobre la de usuario |
.omc/ | Raíz de estado runtime (sesiones, planes, logs) |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS | Variable de entorno para habilitar equipos nativos |
OMC_STATE_DIR | Para que el estado sobreviva a la eliminación de un worktree |
Trampas frecuentes y soluciones
- Instalar dos rutas a la vez: el plugin y el CLI npm son vías separadas; si tienes ambas, actualiza las dos.
- Conflicto de nombre de servidor MCP (
t): al usar--plugin-direl plugin registra su propioty colisiona; solución:{"disabledMcpjsonServers": ["t"]}en~/.claude/settings.json. swarmya no existe: la palabra clave fue eliminada; migra los prompts antiguos a/team.- Windows nativo: experimental; los workers de equipo necesitan psmux o WSL2.
Integraciones y migración
Proveedores externos opcionales: Codex CLI, Gemini CLI, Antigravity (agy), Grok Build. Notificaciones vía Telegram, Discord, Slack y OpenClaw. docs/MIGRATION.md documenta los caminos v2.x → v3.0 y v3.x → v4.0.
Cómo contribuir
CONTRIBUTING.md documenta: prerrequisitos (Node.js ≥ 20, npm, git, Claude Code); fork y clonado con upstream; dos ramas principales (dev para features, main para release); npm install && npm run build; enlazar el checkout como plugin activo con omc --plugin-dir "$PWD" setup --plugin-dir-mode; abrir un PR con la plantilla.
Cómo lo recibió la comunidad
Hacker News — «Sisyphus Now Lives in Oh My Claude» (52 puntos, 38 comentarios, 11 de enero de 2026) muestra el espectro completo: gluszak pregunta si estos orquestadores «hacen algo más que consumir más tokens»; CubsFan1060 dice que «el README parece más interesado en estar enfadado con Anthropic que en decirme qué es esto»; John23832 advierte sobre instalar prompts de una cuenta sin historial con «auto-actualización silenciosa»; LaurensBER señala una ventaja real de velocidad; undeveloper critica que «esto elimina la principal ventaja de opencode, el acceso fácil a muchos modelos».
Un artículo independiente de ZHC Institute (1 de abril de 2026) reporta que OMC llegó a 19 754 estrellas «en lo que parece una semana» y lo enmarca como «el brazo de ingeniería de una Zero-Human Company», matizando que no toma decisiones de negocio ni gestiona transacciones financieras.
oh-my-claudecode frente a otras propuestas
| Proyecto | Coincidencia verificable | Diferencia verificable |
|---|---|---|
code-yeongyu/oh-my-openagent (68 246 ★) | Orquestación de agentes para un CLI de código; inspiración directa citada. | Dirigido a OpenCode, no a Claude Code oficial. |
affaan-m/ECC (242 166 ★) | Sistema de «harness» de optimización de agentes para Claude. | Se presenta como optimización de rendimiento; OMC como orquestación multiagente «de equipos». |
obra/superpowers (276 177 ★) | Marco de habilidades y metodología de desarrollo para agentes de código. | Superpowers impone un proceso; OMC orquesta varios agentes en paralelo con roles. |
jarrodwatts/claude-hud (27 560 ★) | Muestra en el statusbar qué ocurre. | Es solo el HUD; OMC integra ese tipo de visualización y añade orquestación completa. |
Yeachan-Heo/oh-my-codex (32 800 ★) | Misma orquestación, mismo autor. | Para OpenAI Codex CLI; OMC es el equivalente para Claude Code. |
La comparación más útil no es por popularidad: OMC destaca cuando se quiere orquestación multiagente de equipos sobre el Claude Code oficial, sin aprender el CLI a fondo.
Casos de uso y a quién puede ayudar este repositorio
- Desarrolladores que ya usan Claude Code y quieren orquestación multiagente sin aprender el CLI: el flujo plugin +
/autopilotda un pipeline plan → prd → exec → verify → fix con un solo comando. - Equipos que quieren paralelización real con varios modelos:
omc team 2:codex ...+omc team 1:claude ...mezcla Codex y Claude a la vez. - Personas con requisitos vagos:
/deep-interviewobliga a un interrogatorio socrático antes de programar. - Usuarios multi-proveedor: el mismo autor ofrece
oh-my-codexpara Codex; los workers tmux permiten mezclar Claude, Codex, Gemini, Antigravity, Grok y Cursor en un solo comando de equipo. - Integración con pipelines de agentes más amplios: la integración con OpenClaw lo posiciona como «el brazo de ingeniería» dentro de un sistema coordinado por un agente superior.
Recursos
- Repositorio: https://github.com/Yeachan-Heo/oh-my-claudecode
- Sitio oficial: https://oh-my-claudecode.dev
- Documentación: https://yeachan-heo.github.io/oh-my-claudecode-website
- Paquete npm: https://www.npmjs.com/package/oh-my-claude-sisyphus
- Hermano para Codex: https://github.com/Yeachan-Heo/oh-my-codex
- Comunidad / Discord: https://discord.gg/jq6jnSGABY
Nota: este artículo combina el README y la documentación oficial de oh-my-claudecode, la API de GitHub, el registro de npm, búsquedas de repositorios y discusiones de Hacker News, consultados el 22 de agosto de 2026. Las cifras cambian con el tiempo.
Comentarios