oh-my-codex 0.7.6 → 0.8.1

package/README.de.md

@@ -0,0 +1,315 @@
+# oh-my-codex (OMX)
+
+<p align="center">
+  <img src="https://yeachan-heo.github.io/oh-my-codex-website/omx-character-nobg.png" alt="oh-my-codex character" width="280">
+  <br>
+  <em>Dein Codex ist nicht allein.</em>
+</p>
+
+[![npm version](https://img.shields.io/npm/v/oh-my-codex)](https://www.npmjs.com/package/oh-my-codex)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
+
+> **[Website](https://yeachan-heo.github.io/oh-my-codex-website/)** | **[Documentation](https://yeachan-heo.github.io/oh-my-codex-website/docs.html)** | **[CLI Reference](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#cli-reference)** | **[Workflows](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#workflows)** | **[GitHub](https://github.com/Yeachan-Heo/oh-my-codex)** | **[npm](https://www.npmjs.com/package/oh-my-codex)**
+
+Multi-Agenten-Orchestrierungsschicht für [OpenAI Codex CLI](https://github.com/openai/codex).
+
+## Sprachen
+
+- [English](./README.md)
+- [한국어 (Korean)](./README.ko.md)
+- [日本語 (Japanese)](./README.ja.md)
+- [简体中文 (Chinese Simplified)](./README.zh.md)
+- [繁體中文 (Chinese Traditional)](./README.zh-TW.md)
+- [Tiếng Việt (Vietnamese)](./README.vi.md)
+- [Español (Spanish)](./README.es.md)
+- [Português (Portuguese)](./README.pt.md)
+- [Русский (Russian)](./README.ru.md)
+- [Türkçe (Turkish)](./README.tr.md)
+- [Deutsch (German)](./README.de.md)
+- [Français (French)](./README.fr.md)
+- [Italiano (Italian)](./README.it.md)
+
+
+OMX verwandelt Codex von einem Einzelsitzungs-Agenten in ein koordiniertes System mit:
+- Role Prompts (`/prompts:name`) für spezialisierte Agenten
+- Workflow Skills (`$name`) für wiederholbare Ausführungsmodi
+- Team-Orchestrierung in tmux (`omx team`, `$team`)
+- Persistenter Zustand und Speicher über MCP-Server
+
+## Warum OMX
+
+Codex CLI ist stark für direkte Aufgaben. OMX fügt Struktur für größere Arbeiten hinzu:
+- Zerlegung und stufenweise Ausführung (`team-plan -> team-prd -> team-exec -> team-verify -> team-fix`)
+- Persistenter Modus-Lebenszyklus-Zustand (`.omx/state/`)
+- Speicher- und Notepad-Oberflächen für langfristige Sitzungen
+- Operationelle Steuerung für Start, Verifizierung und Abbruch
+
+OMX ist ein Add-on, kein Fork. Es nutzt die nativen Erweiterungspunkte von Codex.
+
+## Voraussetzungen
+
+- macOS oder Linux (Windows über WSL2)
+- Node.js >= 20
+- Codex CLI installiert (`npm install -g @openai/codex`)
+- Codex-Authentifizierung konfiguriert
+
+## Schnellstart (3 Minuten)
+
+```bash
+npm install -g oh-my-codex
+omx setup
+omx doctor
+```
+
+Empfohlenes Startprofil für vertrauenswürdige Umgebungen:
+
+```bash
+omx --xhigh --madmax
+```
+
+## Neu in v0.5.0
+
+- **Bereichsbewusstes Setup** mit `omx setup --scope user|project` für flexible Installationsmodi.
+- **Spark-Worker-Routing** über `--spark` / `--madmax-spark`, damit Team-Worker `gpt-5.3-codex-spark` nutzen können, ohne das Leader-Modell zu erzwingen.
+- **Katalog-Konsolidierung** — veraltete Prompts (`deep-executor`, `scientist`) und 9 veraltete Skills entfernt.
+- **Benachrichtigungs-Detailstufen** für feingranulare CCNotifier-Ausgabesteuerung.
+
+## Erste Sitzung
+
+Innerhalb von Codex:
+
+```text
+/prompts:architect "analyze current auth boundaries"
+/prompts:executor "implement input validation in login"
+$plan "ship OAuth callback safely"
+$team 3:executor "fix all TypeScript errors"
+```
+
+Vom Terminal:
+
+```bash
+omx team 4:executor "parallelize a multi-module refactor"
+omx team status <team-name>
+omx team shutdown <team-name>
+```
+
+## Kernmodell
+
+OMX installiert und verbindet diese Schichten:
+
+```text
+User
+  -> Codex CLI
+    -> AGENTS.md (Orchestrierungs-Gehirn)
+    -> ~/.codex/prompts/*.md (Agenten-Prompt-Katalog)
+    -> ~/.agents/skills/*/SKILL.md (Skill-Katalog)
+    -> ~/.codex/config.toml (Features, Benachrichtigungen, MCP)
+    -> .omx/ (Laufzeitzustand, Speicher, Pläne, Protokolle)
+```
+
+## Hauptbefehle
+
+```bash
+omx                # Codex starten (+ HUD in tmux wenn verfügbar)
+omx setup          # Prompts/Skills/Config nach Bereich installieren + Projekt AGENTS.md/.omx
+omx doctor         # Installations-/Laufzeitdiagnose
+omx doctor --team  # Team/Swarm-Diagnose
+omx team ...       # tmux-Team-Worker starten/Status/fortsetzen/herunterfahren
+omx status         # Aktive Modi anzeigen
+omx cancel         # Aktive Ausführungsmodi abbrechen
+omx reasoning <mode> # low|medium|high|xhigh
+omx tmux-hook ...  # init|status|validate|test
+omx hooks ...      # init|status|validate|test (Plugin-Erweiterungs-Workflow)
+omx hud ...        # --watch|--json|--preset
+omx help
+```
+
+## Hooks-Erweiterung (Additive Oberfläche)
+
+OMX enthält jetzt `omx hooks` für Plugin-Gerüstbau und -Validierung.
+
+- `omx tmux-hook` wird weiterhin unterstützt und ist unverändert.
+- `omx hooks` ist additiv und ersetzt keine tmux-hook-Workflows.
+- Plugin-Dateien befinden sich unter `.omx/hooks/*.mjs`.
+- Plugins sind standardmäßig deaktiviert; aktivieren mit `OMX_HOOK_PLUGINS=1`.
+
+Siehe `docs/hooks-extension.md` für den vollständigen Erweiterungs-Workflow und das Ereignismodell.
+
+## Start-Flags
+
+```bash
+--yolo
+--high
+--xhigh
+--madmax
+--force
+--dry-run
+--verbose
+--scope <user|project>  # nur bei setup
+```
+
+`--madmax` entspricht Codex `--dangerously-bypass-approvals-and-sandbox`.
+Nur in vertrauenswürdigen/externen Sandbox-Umgebungen verwenden.
+
+### MCP workingDirectory-Richtlinie (optionale Härtung)
+
+Standardmäßig akzeptieren MCP-Zustand/Speicher/Trace-Tools das vom Aufrufer bereitgestellte `workingDirectory`.
+Um dies einzuschränken, setzen Sie eine Erlaubnisliste von Wurzelverzeichnissen:
+
+```bash
+export OMX_MCP_WORKDIR_ROOTS="/path/to/project:/path/to/another-root"
+```
+
+Wenn gesetzt, werden `workingDirectory`-Werte außerhalb dieser Wurzeln abgelehnt.
+
+## Codex-First Prompt-Steuerung
+
+Standardmäßig injiziert OMX:
+
+```text
+-c model_instructions_file="<cwd>/AGENTS.md"
+```
+
+Dies schichtet die `AGENTS.md`-Anweisungen des Projekts in die Codex-Startanweisungen.
+Es erweitert das Codex-Verhalten, ersetzt/umgeht aber nicht die Codex-Kernsystemrichtlinien.
+
+Steuerung:
+
+```bash
+OMX_BYPASS_DEFAULT_SYSTEM_PROMPT=0 omx     # AGENTS.md-Injektion deaktivieren
+OMX_MODEL_INSTRUCTIONS_FILE=/path/to/instructions.md omx
+```
+
+## Team-Modus
+
+Verwenden Sie den Team-Modus für umfangreiche Arbeiten, die von parallelen Workern profitieren.
+
+Lebenszyklus:
+
+```text
+start -> assign scoped lanes -> monitor -> verify terminal tasks -> shutdown
+```
+
+Operationelle Befehle:
+
+```bash
+omx team <args>
+omx team status <team-name>
+omx team resume <team-name>
+omx team shutdown <team-name>
+```
+
+Wichtige Regel: Fahren Sie nicht herunter, während Aufgaben noch `in_progress` sind, es sei denn, Sie brechen ab.
+
+### Ralph-Aufräumrichtlinie
+
+Wenn ein Team im Ralph-Modus läuft (`omx team ralph ...`), wendet die Shutdown-Bereinigung
+eine spezielle Richtlinie an, die sich vom normalen Pfad unterscheidet:
+
+| Verhalten | Normales Team | Ralph-Team |
+|---|---|---|
+| Erzwungenes Herunterfahren bei Fehler | Wirft `shutdown_gate_blocked` | Umgeht Gate, protokolliert `ralph_cleanup_policy`-Ereignis |
+| Automatische Branch-Löschung | Löscht Worktree-Branches bei Rollback | Bewahrt Branches (`skipBranchDeletion`) |
+| Abschluss-Protokollierung | Standard-`shutdown_gate`-Ereignis | Zusätzliches `ralph_cleanup_summary`-Ereignis mit Aufgabenaufschlüsselung |
+
+Die Ralph-Richtlinie wird automatisch aus dem Team-Modus-Zustand (`linked_ralph`) erkannt oder
+kann explizit über `omx team shutdown <name> --ralph` übergeben werden.
+
+Worker-CLI-Auswahl für Team-Worker:
+
+```bash
+OMX_TEAM_WORKER_CLI=auto    # Standard; verwendet claude wenn Worker --model "claude" enthält
+OMX_TEAM_WORKER_CLI=codex   # Codex-CLI-Worker erzwingen
+OMX_TEAM_WORKER_CLI=claude  # Claude-CLI-Worker erzwingen
+OMX_TEAM_WORKER_CLI_MAP=codex,codex,claude,claude  # CLI-Mix pro Worker (Länge=1 oder Worker-Anzahl)
+OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # optional: adaptiven Queue->Resend-Fallback deaktivieren
+```
+
+Hinweise:
+- Worker-Startargumente werden weiterhin über `OMX_TEAM_WORKER_LAUNCH_ARGS` geteilt.
+- `OMX_TEAM_WORKER_CLI_MAP` überschreibt `OMX_TEAM_WORKER_CLI` für Worker-spezifische Auswahl.
+- Trigger-Übermittlung verwendet standardmäßig adaptive Wiederholungsversuche (Queue/Submit, dann sicherer Clear-Line+Resend-Fallback bei Bedarf).
+- Im Claude-Worker-Modus startet OMX Worker als einfaches `claude` (keine zusätzlichen Startargumente) und ignoriert explizite `--model` / `--config` / `--effort`-Überschreibungen, sodass Claude die Standard-`settings.json` verwendet.
+
+## Was `omx setup` schreibt
+
+- `.omx/setup-scope.json` (persistierter Setup-Bereich)
+- Bereichsabhängige Installationen:
+  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`
+  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`
+- Startverhalten: Wenn der persistierte Bereich `project` ist, verwendet `omx` automatisch `CODEX_HOME=./.codex` (sofern `CODEX_HOME` nicht bereits gesetzt ist).
+- Vorhandene `AGENTS.md` wird standardmäßig beibehalten. Bei interaktiven TTY-Läufen fragt Setup vor dem Überschreiben; `--force` überschreibt ohne Nachfrage (aktive Sitzungs-Sicherheitsprüfungen gelten weiterhin).
+- `config.toml`-Aktualisierungen (für beide Bereiche):
+  - `notify = ["node", "..."]`
+  - `model_reasoning_effort = "high"`
+  - `developer_instructions = "..."`
+  - `[features] multi_agent = true, child_agents_md = true`
+  - MCP-Server-Einträge (`omx_state`, `omx_memory`, `omx_code_intel`, `omx_trace`)
+  - `[tui] status_line`
+- Projekt-`AGENTS.md`
+- `.omx/`-Laufzeitverzeichnisse und HUD-Konfiguration
+
+## Agenten und Skills
+
+- Prompts: `prompts/*.md` (installiert nach `~/.codex/prompts/` für `user`, `./.codex/prompts/` für `project`)
+- Skills: `skills/*/SKILL.md` (installiert nach `~/.agents/skills/` für `user`, `./.agents/skills/` für `project`)
+
+Beispiele:
+- Agenten: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
+- Skills: `autopilot`, `plan`, `team`, `ralph`, `ultrawork`, `cancel`
+
+## Projektstruktur
+
+```text
+oh-my-codex/
+  bin/omx.js
+  src/
+    cli/
+    team/
+    mcp/
+    hooks/
+    hud/
+    config/
+    modes/
+    notifications/
+    verification/
+  prompts/
+  skills/
+  templates/
+  scripts/
+```
+
+## Entwicklung
+
+```bash
+git clone https://github.com/Yeachan-Heo/oh-my-codex.git
+cd oh-my-codex
+npm install
+npm run build
+npm test
+```
+
+## Dokumentation
+
+- **[Vollständige Dokumentation](https://yeachan-heo.github.io/oh-my-codex-website/docs.html)** — Kompletter Leitfaden
+- **[CLI-Referenz](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#cli-reference)** — Alle `omx`-Befehle, Flags und Tools
+- **[Benachrichtigungs-Leitfaden](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#notifications)** — Discord, Telegram, Slack und Webhook-Einrichtung
+- **[Empfohlene Workflows](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#workflows)** — Praxiserprobte Skill-Ketten für häufige Aufgaben
+- **[Versionshinweise](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#release-notes)** — Neuheiten in jeder Version
+
+## Hinweise
+
+- Vollständiges Änderungsprotokoll: `CHANGELOG.md`
+- Migrationsleitfaden (nach v0.4.4 mainline): `docs/migration-mainline-post-v0.4.4.md`
+- Abdeckungs- und Paritätsnotizen: `COVERAGE.md`
+- Hook-Erweiterungs-Workflow: `docs/hooks-extension.md`
+- Setup- und Beitragsdetails: `CONTRIBUTING.md`
+
+## Danksagungen
+
+Inspiriert von [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode), angepasst für Codex CLI.
+
+## Lizenz
+
+MIT

package/README.es.md

@@ -1,10 +1,60 @@
-# oh-my-codex (OMX) README en Español
+# oh-my-codex (OMX)
 
-> Para la documentación completa original, consulta [English README](./README.md).
+<p align="center">
+  <img src="https://yeachan-heo.github.io/oh-my-codex-website/omx-character-nobg.png" alt="oh-my-codex character" width="280">
+  <br>
+  <em>Tu codex no está solo.</em>
+</p>
 
-OMX es una capa de orquestación multiagente para OpenAI Codex CLI.
+[![npm version](https://img.shields.io/npm/v/oh-my-codex)](https://www.npmjs.com/package/oh-my-codex)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
 
-## Inicio rápido
+> **[Website](https://yeachan-heo.github.io/oh-my-codex-website/)** | **[Documentation](https://yeachan-heo.github.io/oh-my-codex-website/docs.html)** | **[CLI Reference](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#cli-reference)** | **[Workflows](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#workflows)** | **[GitHub](https://github.com/Yeachan-Heo/oh-my-codex)** | **[npm](https://www.npmjs.com/package/oh-my-codex)**
+
+Capa de orquestación multiagente para [OpenAI Codex CLI](https://github.com/openai/codex).
+
+## Idiomas
+
+- [English](./README.md)
+- [한국어 (Korean)](./README.ko.md)
+- [日本語 (Japanese)](./README.ja.md)
+- [简体中文 (Chinese Simplified)](./README.zh.md)
+- [繁體中文 (Chinese Traditional)](./README.zh-TW.md)
+- [Tiếng Việt (Vietnamese)](./README.vi.md)
+- [Español (Spanish)](./README.es.md)
+- [Português (Portuguese)](./README.pt.md)
+- [Русский (Russian)](./README.ru.md)
+- [Türkçe (Turkish)](./README.tr.md)
+- [Deutsch (German)](./README.de.md)
+- [Français (French)](./README.fr.md)
+- [Italiano (Italian)](./README.it.md)
+
+
+OMX convierte Codex de un agente de sesión única en un sistema coordinado con:
+- Role prompts (`/prompts:name`) para agentes especializados
+- Workflow skills (`$name`) para modos de ejecución repetibles
+- Orquestación de equipos en tmux (`omx team`, `$team`)
+- Estado persistente y memoria a través de servidores MCP
+
+## Por qué OMX
+
+Codex CLI es potente para tareas directas. OMX añade estructura para trabajo más amplio:
+- Descomposición y ejecución por etapas (`team-plan -> team-prd -> team-exec -> team-verify -> team-fix`)
+- Estado persistente del ciclo de vida de modos (`.omx/state/`)
+- Superficies de memoria y bloc de notas para sesiones prolongadas
+- Controles operacionales para inicio, verificación y cancelación
+
+OMX es un complemento, no un fork. Utiliza los puntos de extensión nativos de Codex.
+
+## Requisitos
+
+- macOS o Linux (Windows vía WSL2)
+- Node.js >= 20
+- Codex CLI instalado (`npm install -g @openai/codex`)
+- Autenticación de Codex configurada
+
+## Inicio rápido (3 minutos)
 
 ```bash
 npm install -g oh-my-codex
@@ -12,25 +62,254 @@ omx setup
 omx doctor
 ```
 
-## Funcionalidades clave
+Perfil de inicio recomendado para entornos de confianza:
 
-- Ejecución de agentes especializados con prompts de rol (`/prompts:name`)
-- Automatización de flujos repetibles con skills (`$name`)
-- Orquestación en equipo con tmux (`omx team`, `$team`)
-- Estado y memoria persistentes mediante servidores MCP
+```bash
+omx --xhigh --madmax
+```
+
+## Novedades en v0.5.0
+
+- **Configuración con alcance** mediante `omx setup --scope user|project` para modos de instalación flexibles.
+- **Enrutamiento de Spark worker** vía `--spark` / `--madmax-spark` — los workers del equipo pueden usar `gpt-5.3-codex-spark` sin forzar el modelo líder.
+- **Consolidación del catálogo** — se eliminaron prompts obsoletos (`deep-executor`, `scientist`) y 9 skills obsoletos para una superficie más compacta.
+- **Niveles de detalle de notificaciones** para control granular de la salida de CCNotifier.
+
+## Primera sesión
+
+Dentro de Codex:
+
+```text
+/prompts:architect "analyze current auth boundaries"
+/prompts:executor "implement input validation in login"
+$plan "ship OAuth callback safely"
+$team 3:executor "fix all TypeScript errors"
+```
+
+Desde la terminal:
+
+```bash
+omx team 4:executor "parallelize a multi-module refactor"
+omx team status <team-name>
+omx team shutdown <team-name>
+```
+
+## Modelo central
+
+OMX instala y conecta estas capas:
+
+```text
+User
+  -> Codex CLI
+    -> AGENTS.md (cerebro de orquestación)
+    -> ~/.codex/prompts/*.md (catálogo de prompts de agentes)
+    -> ~/.agents/skills/*/SKILL.md (catálogo de skills)
+    -> ~/.codex/config.toml (características, notificaciones, MCP)
+    -> .omx/ (estado en ejecución, memoria, planes, registros)
+```
 
 ## Comandos principales
 
 ```bash
-omx
-omx setup
-omx doctor
+omx                # Lanzar Codex (+ HUD en tmux cuando está disponible)
+omx setup          # Instalar prompts/skills/config por alcance + proyecto AGENTS.md/.omx
+omx doctor         # Diagnósticos de instalación/ejecución
+omx doctor --team  # Diagnósticos de Team/swarm
+omx team ...       # Iniciar/estado/reanudar/apagar workers tmux del equipo
+omx status         # Mostrar modos activos
+omx cancel         # Cancelar modos de ejecución activos
+omx reasoning <mode> # low|medium|high|xhigh
+omx tmux-hook ...  # init|status|validate|test
+omx hooks ...      # init|status|validate|test (flujo de trabajo de extensión de plugins)
+omx hud ...        # --watch|--json|--preset
+omx help
+```
+
+## Extensión de Hooks (Superficie adicional)
+
+OMX ahora incluye `omx hooks` para scaffolding y validación de plugins.
+
+- `omx tmux-hook` sigue siendo compatible y no ha cambiado.
+- `omx hooks` es aditivo y no reemplaza los flujos de trabajo de tmux-hook.
+- Los archivos de plugins se encuentran en `.omx/hooks/*.mjs`.
+- Los plugins están desactivados por defecto; actívalos con `OMX_HOOK_PLUGINS=1`.
+
+Consulta `docs/hooks-extension.md` para el flujo de trabajo completo de extensiones y el modelo de eventos.
+
+## Flags de inicio
+
+```bash
+--yolo
+--high
+--xhigh
+--madmax
+--force
+--dry-run
+--verbose
+--scope <user|project>  # solo para setup
+```
+
+`--madmax` se mapea a Codex `--dangerously-bypass-approvals-and-sandbox`.
+Úsalo solo en entornos sandbox de confianza o externos.
+
+### Política de workingDirectory MCP (endurecimiento opcional)
+
+Por defecto, las herramientas MCP de state/memory/trace aceptan el `workingDirectory` proporcionado por el llamador.
+Para restringir esto, establece una lista de raíces permitidas:
+
+```bash
+export OMX_MCP_WORKDIR_ROOTS="/path/to/project:/path/to/another-root"
+```
+
+Cuando se establece, los valores de `workingDirectory` fuera de estas raíces son rechazados.
+
+## Control de prompts Codex-First
+
+Por defecto, OMX inyecta:
+
+```text
+-c model_instructions_file="<cwd>/AGENTS.md"
+```
+
+Esto añade las instrucciones del proyecto `AGENTS.md` a los comandos de inicio de Codex.
+Extiende el comportamiento de Codex, pero no reemplaza ni elude las políticas centrales del sistema Codex.
+
+Controles:
+
+```bash
+OMX_BYPASS_DEFAULT_SYSTEM_PROMPT=0 omx     # desactivar inyección de AGENTS.md
+OMX_MODEL_INSTRUCTIONS_FILE=/path/to/instructions.md omx
+```
+
+## Modo equipo
+
+Usa el modo equipo para trabajo amplio que se beneficia de workers paralelos.
+
+Ciclo de vida:
+
+```text
+start -> assign scoped lanes -> monitor -> verify terminal tasks -> shutdown
+```
+
+Comandos operacionales:
+
+```bash
 omx team <args>
-omx status
-omx cancel
+omx team status <team-name>
+omx team resume <team-name>
+omx team shutdown <team-name>
 ```
 
-## Más información
+Regla importante: no apagues mientras las tareas estén en estado `in_progress` a menos que estés abortando.
+
+### Política de limpieza Ralph
+
+Cuando un equipo se ejecuta en modo ralph (`omx team ralph ...`), la limpieza al apagar
+aplica una política dedicada diferente a la ruta normal:
+
+| Comportamiento | Equipo normal | Equipo Ralph |
+|---|---|---|
+| Apagado forzado en caso de fallo | Lanza `shutdown_gate_blocked` | Omite la puerta, registra evento `ralph_cleanup_policy` |
+| Eliminación automática de ramas | Elimina ramas de worktree en rollback | Preserva ramas (`skipBranchDeletion`) |
+| Registro de finalización | Evento estándar `shutdown_gate` | Evento adicional `ralph_cleanup_summary` con desglose de tareas |
+
+La política Ralph se detecta automáticamente del estado del modo equipo (`linked_ralph`) o
+se puede pasar explícitamente vía `omx team shutdown <name> --ralph`.
+
+Selección de Worker CLI para los workers del equipo:
+
+```bash
+OMX_TEAM_WORKER_CLI=auto    # predeterminado; usa claude cuando worker --model contiene "claude"
+OMX_TEAM_WORKER_CLI=codex   # forzar workers Codex CLI
+OMX_TEAM_WORKER_CLI=claude  # forzar workers Claude CLI
+OMX_TEAM_WORKER_CLI_MAP=codex,codex,claude,claude  # mezcla de CLI por worker (longitud=1 o cantidad de workers)
+OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # opcional: desactivar fallback adaptativo queue->resend
+```
+
+Notas:
+- Los argumentos de inicio de workers se comparten a través de `OMX_TEAM_WORKER_LAUNCH_ARGS`.
+- `OMX_TEAM_WORKER_CLI_MAP` anula `OMX_TEAM_WORKER_CLI` para selección por worker.
+- El envío de triggers usa reintentos adaptativos por defecto (queue/submit, luego fallback seguro clear-line+resend cuando es necesario).
+- En modo Claude worker, OMX lanza workers como `claude` simple (sin argumentos de inicio extra) e ignora anulaciones explícitas de `--model` / `--config` / `--effort` para que Claude use el `settings.json` predeterminado.
+
+## Qué escribe `omx setup`
+
+- `.omx/setup-scope.json` (alcance de instalación persistido)
+- Instalaciones dependientes del alcance:
+  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`
+  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`
+- Comportamiento de inicio: si el alcance persistido es `project`, el lanzamiento de `omx` usa automáticamente `CODEX_HOME=./.codex` (a menos que `CODEX_HOME` ya esté establecido).
+- El `AGENTS.md` existente se preserva por defecto. En ejecuciones TTY interactivas, setup pregunta antes de sobrescribir; `--force` sobrescribe sin preguntar (las verificaciones de seguridad de sesiones activas siguen aplicándose).
+- Actualizaciones de `config.toml` (para ambos alcances):
+  - `notify = ["node", "..."]`
+  - `model_reasoning_effort = "high"`
+  - `developer_instructions = "..."`
+  - `[features] multi_agent = true, child_agents_md = true`
+  - Entradas de servidores MCP (`omx_state`, `omx_memory`, `omx_code_intel`, `omx_trace`)
+  - `[tui] status_line`
+- `AGENTS.md` del proyecto
+- Directorios `.omx/` de ejecución y configuración de HUD
+
+## Agentes y skills
+
+- Prompts: `prompts/*.md` (instalados en `~/.codex/prompts/` para `user`, `./.codex/prompts/` para `project`)
+- Skills: `skills/*/SKILL.md` (instalados en `~/.agents/skills/` para `user`, `./.agents/skills/` para `project`)
+
+Ejemplos:
+- Agentes: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
+- Skills: `autopilot`, `plan`, `team`, `ralph`, `ultrawork`, `cancel`
+
+## Estructura del proyecto
+
+```text
+oh-my-codex/
+  bin/omx.js
+  src/
+    cli/
+    team/
+    mcp/
+    hooks/
+    hud/
+    config/
+    modes/
+    notifications/
+    verification/
+  prompts/
+  skills/
+  templates/
+  scripts/
+```
+
+## Desarrollo
+
+```bash
+git clone https://github.com/Yeachan-Heo/oh-my-codex.git
+cd oh-my-codex
+npm install
+npm run build
+npm test
+```
+
+## Documentación
+
+- **[Documentación completa](https://yeachan-heo.github.io/oh-my-codex-website/docs.html)** — Guía completa
+- **[Referencia CLI](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#cli-reference)** — Todos los comandos `omx`, flags y herramientas
+- **[Guía de notificaciones](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#notifications)** — Configuración de Discord, Telegram, Slack y webhooks
+- **[Flujos de trabajo recomendados](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#workflows)** — Cadenas de skills probadas en batalla para tareas comunes
+- **[Notas de versión](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#release-notes)** — Novedades en cada versión
+
+## Notas
+
+- Registro de cambios completo: `CHANGELOG.md`
+- Guía de migración (post-v0.4.4 mainline): `docs/migration-mainline-post-v0.4.4.md`
+- Notas de cobertura y paridad: `COVERAGE.md`
+- Flujo de trabajo de extensión de hooks: `docs/hooks-extension.md`
+- Detalles de instalación y contribución: `CONTRIBUTING.md`
+
+## Agradecimientos
+
+Inspirado en [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode), adaptado para Codex CLI.
+
+## Licencia
 
-- Documento principal: [README.md](./README.md)
-- Sitio web: https://yeachan-heo.github.io/oh-my-codex-website/
+MIT