04 de agosto de 2026 · Por YasKad
code-yeongyu/oh-my-openagent

Oh My OpenAgent: una capa de orquestación opinada para agentes de código

code-yeongyu/oh-my-openagent · 69.408★ · 5.716 forks

Todo lo que hay que saber sobre code-yeongyu/oh-my-openagent: un arnés para OpenCode y una edición reducida para Codex CLI que combinan roles de agentes, ganchos, herramientas y reglas de proyecto.


Qué es Oh My OpenAgent

Oh My OpenAgent (también omo, y antes oh-my-opencode) es un proyecto de automatización para agentes de programación. Su edición Ultimate se instala como complemento de OpenCode; su edición Light, distribuida mediante LazyCodex, instala componentes portables dentro de Codex CLI. No es un modelo: organiza cómo un agente utiliza modelos, herramientas, reglas y subagentes.

Comparación visual entre dos entornos: un centro de mando futurista con múltiples agentes holográficos para la edición Ultimate y una terminal minimalista de un solo operador para la edición Light.

El repositorio presenta el caso de uso como entregar tareas grandes a un agente: el usuario formula el objetivo y el sistema planifica, delega, busca documentación, modifica código y conserva comprobaciones. La documentación distingue con claridad las dos ediciones:

  • Ultimate / OpenCode: 11 agentes especializados, más de 54 ganchos del ciclo de vida, MCP incorporados, comandos, modo de equipo, ulw-loop y ediciones Hashline.
  • Light / Codex CLI: reglas, comprobador de comentarios, Git Bash, LSP, ultrawork, ulw-loop, continuidad de trabajo y telemetría; carece deliberadamente de la orquestación de equipo, pues el proyecto atribuye esa superficie al propio Codex CLI.

El origen: de Oh My OpenCode a un arnés multi-entorno

La API de GitHub fecha la creación de code-yeongyu/oh-my-openagent el 3 de diciembre de 2025. Su autor es YeonGyu-Kim (code-yeongyu), cuya cuenta se identifica con la biografía «Hacker», ubicación en Seúl y afiliación declarada a @sionic-ai.

El nombre conserva una historia de transición: la documentación explica que el paquete y el binario se publicaron como oh-my-opencode y que el nombre nuevo se publica en paralelo durante el cambio. La configuración reconoce tanto oh-my-openagent como la entrada heredada, aunque esta última emite una advertencia. La edición para Codex se llama LazyCodex, y el README aclara que su nombre está inspirado en LazyVim; no es el nombre del mercado de Codex.

El relato del autor en el README es deliberadamente personal: declara haber consumido 24.000 dólares en tokens de LLM en proyectos propios, haber probado herramientas y configuraciones, y haber llegado a OpenCode. Esa experiencia sirve como justificación de un producto con muchas decisiones preconfiguradas. También documenta una tensión con proveedores: afirma que Anthropic bloqueó OpenCode por el uso que hacían de sus modelos; es una afirmación del proyecto enlazada a una publicación de X, no una confirmación independiente de Anthropic. De ahí su énfasis actual en un mercado abierto de proveedores y en no depender de un único modelo.

Estación de trabajo cyberpunk con pantallas holográficas de código TypeScript, métricas de GitHub y un documento de hoja de ruta, con la silueta de un hacker en Seúl al fondo.

Filosofía y principios

La filosofía declarada es priorizar el rendimiento del agente en tareas extensas, no minimizar la complejidad visual para la persona que mantiene el repositorio. Su ROADMAP.md resume esa posición: el agente piensa, decide y ejecuta; la persona inicia el trabajo.

Cinco personajes de neón representan a los agentes especializados Sisyphus, Prometheus, Oracle, Librarian y Explore dispuestos en una cuadrícula futurista.

Principios verificables en la documentación:

  • Asignar roles, no solo modelos: Sisyphus orquesta; Prometheus planifica; Oracle revisa arquitectura y depuración; Librarian busca documentación y código; Explore explora rápido la base de código. La categoría de trabajo selecciona una cadena de modelos y proveedores.
  • Planificación antes de ejecución: Prometheus entrevista al usuario y redacta planes en .omo/plans/; Metis detecta huecos y Momus y Oracle pueden revisar el plan en paralelo.
  • Contexto y reglas como infraestructura: AGENTS.md y .omo/rules/** se cargan automáticamente. /init-deep genera archivos AGENTS.md jerárquicos para repartir el contexto por directorios.
  • Herramientas bajo demanda: los MCP ligados a habilidades se inician para la tarea y se retiran después, en lugar de ocupar permanentemente el contexto.
  • Comprobación ante cambios obsoletos: Hashline etiqueta líneas con un hash de contenido; si el archivo cambió desde la lectura, rechaza la edición en vez de aplicar una referencia de línea caducada.

Editor de código futurista donde cada línea lleva un hash de contenido en neón; un cursor de IA intenta editar una línea desactualizada y un escudo holográfico rojo rechaza el cambio.

La contrapartida es una postura muy intervencionista: más ganchos, agentes, permisos y rutas de configuración aumentan las posibilidades de automatización, pero también amplían la superficie operativa que hay que revisar.

Cómo funciona

Instalación y activación

Para OpenCode, el comando documentado es bunx oh-my-openagent install; para Codex CLI, npx lazycodex-ai install. La alternativa no interactiva de Codex es npx lazycodex-ai install --no-tui --codex-autonomous. El README advierte expresamente que npx omo no debe emplearse porque corresponde a otro paquete de npm no relacionado.

En Codex, el instalador escribe el complemento omo@sisyphuslabs, definiciones de agentes y estados de confianza de ganchos con SHA-256 en ~/.codex/config.toml. Los ganchos deben aprobarse en el siguiente inicio de Codex; según la guía, no se ejecutan antes de esa aprobación. El modo autónomo de la instalación por npx puede configurar approval_policy = "never", sandbox_mode = "danger-full-access" y acceso de red; es una decisión explícita que merece revisión de seguridad antes de aceptarla.

Terminal en modo oscuro que muestra el comando de instalación bunx oh-my-openagent install junto con advertencias holográficas sobre la aprobación de ganchos mediante SHA-256.

Flujo de trabajo y funciones

El atajo principal es escribir ultrawork o ulw: en Ultimate activa la orquestación completa, y en Light activa el componente correspondiente de Codex. Para trabajos precisos, la guía recomienda entrar en planificación y utilizar /start-work para que Prometheus entreviste, prepare y someta el plan a revisión.

Mesa holográfica futurista con planos, árboles de archivos y directorios .omo/plans/ flotando en el aire, revisados por entidades de IA translúcidas.

En Ultimate, Team Mode es opcional. Un líder puede crear hasta ocho integrantes en paralelo, visualizar la actividad con tmux y usar herramientas team_* para mensajes, tareas, estado y cierre. Dos habilidades se montan sobre esa capa: hyperplan, que enfrenta cinco críticos al plan, y security-research.

Centro de mando futurista que visualiza el Team Mode: un líder central coordina ocho paneles de terminal paralelos con actividad de código y estado de tareas en tiempo real.

Las herramientas integradas incluyen LSP para diagnósticos, navegación, símbolos y renombrado; ast-grep; terminal tmux; y MCP para búsqueda web, documentación y código. La edición Light comparte LSP, reglas, ulw-loop y sus propios MCP limitados, pero no los agentes ni team_*.

Estado oficial y semioficial

El estado es semioficial y acotado por plataforma:

  • La documentación de Oh My OpenAgent afirma que la edición Light se instala mediante el mercado de complementos de Codex CLI, con el mercado sisyphuslabs y el complemento omo. Esto significa que Codex puede administrar su instalación, actualización y aprobación de ganchos; no significa que OpenAI avale la metodología, su seguridad o sus resultados.
  • Para OpenCode se presenta como complemento del host, no como una función nativa de OpenCode.
  • El README declara compatibilidad de Ultimate con elementos de Claude Code —ganchos, comandos, habilidades, MCP y complementos—, pero el ROADMAP.md clasifica los futuros adaptadores para Claude Code, Amp y Droid como exploratorios, no confirmados.

No se recuperó una certificación, patrocinio o designación formal de estándar de OpenAI, OpenCode, Anthropic u otro proveedor. Con 67.005 estrellas y múltiples adaptaciones, funciona de hecho como una referencia visible del patrón de arnés multiagente, pero esa es una interpretación de adopción, no un estatus oficial.

El ecosistema

Repositorios del autor y componentes próximos

La consulta de repositorios públicos de code-yeongyu recuperó estos proyectos relacionados o reutilizados por la arquitectura:

  • code-yeongyu/lazycodex — arnés para Codex con memoria de proyecto, planificación, ejecución y finalización verificada; 3.051 estrellas y 192 bifurcaciones. Es el repositorio y el instalador vinculados a la edición Light.
  • code-yeongyu/senpi — bifurcación opinada de badlogic/pi-mono con extensiones; 324 estrellas y 44 bifurcaciones. El ROADMAP.md identifica un adaptador Senpi y una configuración omo.json ya desplegada primero en ese entorno.
  • code-yeongyu/lsp-tools-mcp — herramientas LSP expuestas como servidor MCP por stdio, consumidas por Codex LSP y Oh My OpenAgent; 7 estrellas y 9 bifurcaciones.
  • code-yeongyu/codex-rules — complemento de Codex que inyecta reglas de proyecto mediante ganchos; 9 estrellas. El mismo principio de carga de reglas aparece en la edición Light.
  • code-yeongyu/pi-rules y code-yeongyu/pi-goal — extensiones para Pi de reglas y seguimiento persistente de objetivos; 8 y 17 estrellas, respectivamente.

El plan técnico divide el código en núcleo TypeScript puro, servidores MCP, habilidades estáticas, adaptadores específicos y lanzadores de plataforma. Declara 19 paquetes de núcleo extraídos y sitúa a OpenCode, Codex y Senpi como adaptadores actuales; por tanto, la relación entre esos repositorios no es solo temática, sino parte de la estrategia de reutilización.

Monolito de neón inscrito con «67.005 estrellas» rodeado de nodos satélite que representan bifurcaciones, complementos y adaptaciones de la comunidad en una red vasta.

Puertos, bifurcaciones y extensiones de la comunidad

La búsqueda de repositorios de GitHub por nombre exacto recuperó puertos y complementos, incluidos trabajos no ingleses:

  • HanTechnology/oh-my-openagent-toolkit — kit acompañante para OpenCode, con enrutamiento y superficies de habilidades; 37 estrellas y 4 bifurcaciones.
  • junlin-233/oh-my-lite-openagent — complemento ligero de subagentes compatible con OpenCode; 8 estrellas.
  • eugenejahn/oh-my-openagent-copilot — puerto de orquestación multiagente para GitHub Copilot CLI; 7 estrellas.
  • oneforce/oh-my-openagent-gemini — adaptación para Gemini CLI descrita en chino; 2 estrellas.
  • zaxcler/oh-my-openagent-swtich — configuración para cambiar modelos y agentes, con descripción en chino; 3 estrellas.
  • Vera-l7/oh-my-openagent-droid — adaptación para Factory Droid, que enumera agentes, ultrawork, Hashline y ganchos; sin estrellas en la respuesta de búsqueda consultada.
  • andersou/oh-my-openagent-vscode-extension — extensión de VS Code; 2 estrellas.

Son repositorios de terceros encontrados por búsqueda, no distribuciones aprobadas por el autor. Sus cifras no acreditan compatibilidad, mantenimiento ni seguridad; en particular, un puerto puede copiar la marca sin compartir el código o las garantías del original.

Números del repo

Medición: 1 de agosto de 2026, API y página de GitHub.

MétricaValor
Estrellas67.005
Bifurcaciones5.467
Suscriptores reales221
Commits11.775
Incidencias abiertas según la API956
Ramas / etiquetas mostradas en GitHub152 / 245
Lenguaje principalTypeScript
LicenciaSustainable Use License 1.0
Creación3 de diciembre de 2025
Última versiónv4.19.4, 1 de agosto de 2026

El conteo de commits procede de la última página indicada por la cabecera de paginación de la API. Los contribuidores principales devueltos por la API fueron code-yeongyu (9.060 contribuciones), github-actions[bot] (696), sisyphus-dev-ai (252), justsisyphus (239) y MoerAI (203). El desglose de lenguajes sitúa TypeScript primero, seguido por JavaScript, HTML, Shell y Python.

La licencia merece atención: permite uso interno empresarial, no comercial o personal, y condiciona distribución y modificaciones; no es una licencia de código abierto permisiva. Además, open_issues_count puede incluir solicitudes de cambios abiertas; no debe interpretarse como incidencias exclusivamente. watchers_count replica las estrellas en la respuesta general de GitHub, por lo que se informa subscribers_count como el número de suscriptores real.

Cómo contribuir

No se recuperó un CONTRIBUTING.md independiente ni una plantilla de solicitud de cambios en las fuentes consultadas. Sí hay un proceso concreto para el trabajo prioritario: el README y ROADMAP.md piden leer primero la hoja de ruta de la refactorización multi-entorno y etiquetar con ROADMAP las solicitudes de cambios vinculadas a ella.

La hoja de ruta exige extracciones conservadoras: mover lógica al núcleo TypeScript, reexportarla desde el lugar antiguo, verificar pruebas y solo después eliminar duplicación. Ese procedimiento, junto con la separación propuesta entre núcleo, MCP, habilidades, adaptadores y lanzadores, ofrece un criterio verificable para contribuciones de arquitectura. Para cambios generales, el repositorio no documenta en el material recuperado un flujo adicional de ramas o una plantilla de PR.

Cómo lo recibió la comunidad

La recepción recuperada es mixta y se concentra en comentarios dentro de debates sobre agentes de código, más que en un gran lanzamiento propio en Hacker News:

  • En el hilo de OpenCode 47460525, con 1.274 puntos y 95 comentarios, grapheneposter dijo que probó la herramienta cuando Oh My OpenAgent empezaba a difundirse y la encontró «muy inestable», por lo que volvió a herramientas internas. Es una objeción de experiencia personal y no una evaluación reproducible.
  • En 47633396, con 1.099 puntos y 177 comentarios, josh_p se declaró satisfecho usándolo en OpenCode con dos familias de modelos; valoró que el autor adapte instrucciones a cada modelo, aunque también cuestionó si esa diferenciación importaba realmente. El mismo comentario mezcla elogio y cautela metodológica.
  • En 48278610, con 323 puntos y 52 comentarios, regexorcist destacó la planificación y ejecución mediante subagentes de roles distintos. En un comentario de ese hilo no aporta mediciones ni una comparación controlada, por lo que es evidencia de uso, no de rendimiento cuantificado.
  • En 48553224, con 1.151 puntos y 217 comentarios, jeremyjh explicó que automatiza el reparto de subtareas y los reemplazos de modelos según límites de uso, y afirmó ejecutarlo en una caja aislada sin comunicaciones externas. Esto ilustra un uso avanzado de la asignación por rol, pero no invalida la telemetría que el propio proyecto documenta como activada por defecto.
  • En 48847407, con 151 puntos y 23 comentarios, mdgld calificó el sistema de ganchos y complementos como «gigantesco», aunque lo citó entre las configuraciones que había probado. Es una crítica concreta al peso de la arquitectura, coherente con la gran superficie de configuración de Ultimate.

El proyecto sí documenta telemetría anónima predeterminada, con un evento como máximo diario por máquina y un identificador de instalación con SHA-256; puede desactivarse mediante configuración o variables OMO_DISABLE_POSTHOG y OMO_SEND_ANONYMOUS_TELEMETRY. Es un hecho de la documentación del proyecto, no una auditoría independiente de privacidad.

Oh My OpenAgent frente a otras propuestas

PropuestaCoincidencia verificableDiferencia verificable
gsd-build/get-shit-doneSistema de metaprompts, ingeniería de contexto y desarrollo guiado por especificaciones para Claude Code.Un usuario de HN lo caracterizó como similar a Oh My OpenAgent; la fuente recuperada no acredita equivalencia técnica. GSD tenía 64.783 estrellas en la API consultada.
Yeachan-Heo/oh-my-codexAñade ganchos, equipos de agentes y HUD a Codex.El README de Oh My OpenAgent reconoce que las ideas de Ultragoal y UltraQA se inspiraron en él, pero afirma reimplementarlas. Oh My Codex tenía 32.370 estrellas.
code-yeongyu/lazycodexComparte autor y apunta a memoria, planificación, ejecución y verificación en Codex.Es la vía ligera de Codex asociada a este ecosistema, mientras Ultimate conserva la orquestación de 11 agentes de OpenCode.
code-yeongyu/senpiForma parte de la estrategia de adaptadores de la hoja de ruta.Senpi es una bifurcación orientada a Pi; la guía marca OpenCode como el host principal actual de Ultimate.

La comparación útil no es solo por estrellas: Oh My OpenAgent destaca cuando se desea un arnés que imponga roles, ganchos y enrutamiento de modelos. Puede ser excesivo cuando la prioridad es mantener una integración pequeña y fácilmente auditable.

Casos de uso y a quién puede ayudar este repositorio

Equipos que trabajan con OpenCode y necesitan repartir una tarea de programación amplia pueden usar Ultimate para iniciar ultrawork, preparar un plan con Prometheus en .omo/plans/, pedir revisiones de Metis, Momus u Oracle y delegar exploración o documentación a los roles correspondientes. Cuando el trabajo admite paralelismo, Team Mode permite crear hasta ocho integrantes, seguir tareas y mensajes desde tmux y cerrar el equipo al terminar; LSP, ast-grep y Hashline aportan comprobaciones durante la edición.

Usuarios de Codex CLI que prefieren una capa más acotada pueden instalar LazyCodex para emplear reglas, LSP, ulw-loop, continuidad de trabajo y telemetría sin la orquestación de equipo de Ultimate. También es un punto de partida para quienes quieran organizar instrucciones por proyecto con AGENTS.md y .omo/rules/**. Antes de habilitar la instalación autónoma, deben revisar los permisos, los ganchos pendientes de aprobación y la telemetría, ya que el modo documentado puede configurar acceso amplio al sistema y a la red.

Recursos


Nota: este artículo combina el README, la documentación, ROADMAP.md, la licencia, la API de GitHub y conversaciones de Hacker News recuperadas el 1 de agosto de 2026. Las cifras corresponden a ese momento.

Comentarios