oh-my-codex 0.10.6 → 0.11.0

package/Cargo.lock

@@ -2,10 +2,170 @@
 # It is not intended for manual editing.
 version = 4
 
+[[package]]
+name = "fs2"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9564fc758e15025b46aa6643b1b77d047d1a56a1aea6e01002ac0c7026876213"
+dependencies = [
+ "libc",
+ "winapi",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92ecc6618181def0457392ccd0ee51198e065e016d1d527a7ac1b6dc7c1f09d2"
+
+[[package]]
+name = "libc"
+version = "0.2.183"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b5b646652bf6661599e1da8901b3b9522896f01e736bad5f723fe7a3a27f899d"
+
+[[package]]
+name = "memchr"
+version = "2.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79"
+
 [[package]]
 name = "omx-explore-harness"
-version = "0.10.1"
+version = "0.11.0"
+
+[[package]]
+name = "omx-mux"
+version = "0.11.0"
+dependencies = [
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "omx-runtime"
+version = "0.11.0"
+dependencies = [
+ "omx-mux",
+ "omx-runtime-core",
+ "serde_json",
+]
+
+[[package]]
+name = "omx-runtime-core"
+version = "0.11.0"
+dependencies = [
+ "fs2",
+ "serde",
+ "serde_json",
+]
 
 [[package]]
 name = "omx-sparkshell"
-version = "0.10.1"
+version = "0.11.0"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.149"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "83fc039473c5595ace860d8c4fafa220ff474b3fc6bfdb4293327f1a37e94d86"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "winapi"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419"
+dependencies = [
+ "winapi-i686-pc-windows-gnu",
+ "winapi-x86_64-pc-windows-gnu",
+]
+
+[[package]]
+name = "winapi-i686-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
+
+[[package]]
+name = "winapi-x86_64-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
+
+[[package]]
+name = "zmij"
+version = "1.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"

package/Cargo.toml

@@ -1,9 +1,15 @@
 [workspace]
-members = ["crates/omx-explore", "native/omx-sparkshell"]
+members = [
+  "crates/omx-explore",
+  "crates/omx-mux",
+  "crates/omx-runtime-core",
+  "crates/omx-runtime",
+  "crates/omx-sparkshell",
+]
 resolver = "2"
 
 [workspace.package]
-version = "0.10.2"
+version = "0.11.0"
 edition = "2021"
 license = "MIT"
 repository = "https://github.com/Yeachan-Heo/oh-my-codex"

package/README.de.md

@@ -53,7 +53,7 @@ User
   -> Codex CLI
     -> AGENTS.md (Orchestrierungs-Gehirn)
     -> ~/.codex/prompts/*.md (Agenten-Prompt-Katalog)
-    -> ~/.agents/skills/*/SKILL.md (Skill-Katalog)
+    -> ~/.codex/skills/*/SKILL.md (Skill-Katalog)
     -> ~/.codex/config.toml (Features, Benachrichtigungen, MCP)
     -> .omx/ (Laufzeitzustand, Speicher, Pläne, Protokolle)
 ```
@@ -186,8 +186,8 @@ Hinweise:
 
 - `.omx/setup-scope.json` (persistierter Setup-Bereich)
 - Bereichsabhängige Installationen:
-  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
+  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
+  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
 - Startverhalten: Wenn der persistierte Bereich `project` ist, verwendet `omx` automatisch `CODEX_HOME=./.codex` (sofern `CODEX_HOME` nicht bereits gesetzt ist).
 - Startanweisungen kombinieren `~/.codex/AGENTS.md` (bzw. `CODEX_HOME/AGENTS.md`, wenn überschrieben) mit dem Projekt-`./AGENTS.md` und hängen anschließend die Runtime-Überlagerung an.
 - Vorhandene `AGENTS.md`-Dateien werden nie stillschweigend überschrieben: Interaktive TTY-Läufe fragen vor dem Ersetzen, nicht-interaktive Läufe überspringen das Ersetzen ohne `--force` (aktive Sitzungs-Sicherheitsprüfungen gelten weiterhin).
@@ -204,7 +204,7 @@ Hinweise:
 ## 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`)
+- Skills: `skills/*/SKILL.md` (installiert nach `~/.codex/skills/` für `user`, `./.codex/skills/` für `project`)
 
 Beispiele:
 - Agenten: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`

package/README.es.md

@@ -53,7 +53,7 @@ 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/skills/*/SKILL.md (catálogo de skills)
     -> ~/.codex/config.toml (características, notificaciones, MCP)
     -> .omx/ (estado en ejecución, memoria, planes, registros)
 ```
@@ -186,8 +186,8 @@ Notas:
 
 - `.omx/setup-scope.json` (alcance de instalación persistido)
 - Instalaciones dependientes del alcance:
-  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
+  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
+  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
 - 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).
 - Las instrucciones de inicio combinan `~/.codex/AGENTS.md` (o `CODEX_HOME/AGENTS.md` si se sobrescribe) con `./AGENTS.md` del proyecto y luego añaden la superposición de runtime.
 - Los archivos `AGENTS.md` existentes nunca se sobrescriben silenciosamente: en TTY interactivo se pregunta antes de reemplazar; en modo no interactivo se omite salvo que pases `--force` (las verificaciones de seguridad de sesiones activas siguen aplicándose).
@@ -204,7 +204,7 @@ Notas:
 ## 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`)
+- Skills: `skills/*/SKILL.md` (instalados en `~/.codex/skills/` para `user`, `./.codex/skills/` para `project`)
 
 Ejemplos:
 - Agentes: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`

package/README.fr.md

@@ -53,7 +53,7 @@ User
   -> Codex CLI
     -> AGENTS.md (cerveau d'orchestration)
     -> ~/.codex/prompts/*.md (catalogue de prompts d'agents)
-    -> ~/.agents/skills/*/SKILL.md (catalogue de skills)
+    -> ~/.codex/skills/*/SKILL.md (catalogue de skills)
     -> ~/.codex/config.toml (fonctionnalités, notifications, MCP)
     -> .omx/ (état d'exécution, mémoire, plans, journaux)
 ```
@@ -186,8 +186,8 @@ Notes :
 
 - `.omx/setup-scope.json` (scope de setup persisté)
 - Installations dépendantes du scope :
-  - `user` : `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project` : `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
+  - `user` : `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
+  - `project` : `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
 - Comportement au lancement : si le scope persisté est `project`, le lancement `omx` utilise automatiquement `CODEX_HOME=./.codex` (sauf si `CODEX_HOME` est déjà défini).
 - Les instructions de lancement fusionnent `~/.codex/AGENTS.md` (ou `CODEX_HOME/AGENTS.md` s'il est redéfini) avec `./AGENTS.md` du projet, puis ajoutent l'overlay d'exécution.
 - Les fichiers `AGENTS.md` existants ne sont jamais écrasés silencieusement : en TTY interactif, setup demande avant de remplacer ; en non-interactif, le remplacement est ignoré sauf avec `--force` (les vérifications de sécurité de session active s'appliquent toujours).
@@ -204,7 +204,7 @@ Notes :
 ## Agents et Skills
 
 - Prompts : `prompts/*.md` (installés dans `~/.codex/prompts/` pour `user`, `./.codex/prompts/` pour `project`)
-- Skills : `skills/*/SKILL.md` (installés dans `~/.agents/skills/` pour `user`, `./.agents/skills/` pour `project`)
+- Skills : `skills/*/SKILL.md` (installés dans `~/.codex/skills/` pour `user`, `./.codex/skills/` pour `project`)
 
 Exemples :
 - Agents : `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`

package/README.it.md

@@ -53,7 +53,7 @@ User
   -> Codex CLI
     -> AGENTS.md (cervello dell'orchestrazione)
     -> ~/.codex/prompts/*.md (catalogo prompt degli agenti)
-    -> ~/.agents/skills/*/SKILL.md (catalogo skill)
+    -> ~/.codex/skills/*/SKILL.md (catalogo skill)
     -> ~/.codex/config.toml (funzionalità, notifiche, MCP)
     -> .omx/ (stato di esecuzione, memoria, piani, log)
 ```
@@ -186,8 +186,8 @@ Note:
 
 - `.omx/setup-scope.json` (scope di setup persistito)
 - Installazioni dipendenti dallo scope:
-  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
+  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
+  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
 - Comportamento all'avvio: se lo scope persistito è `project`, l'avvio `omx` usa automaticamente `CODEX_HOME=./.codex` (a meno che `CODEX_HOME` non sia già impostato).
 - Le istruzioni di avvio uniscono `~/.codex/AGENTS.md` (o `CODEX_HOME/AGENTS.md` se ridefinito) con `./AGENTS.md` del progetto, quindi aggiungono l'overlay di runtime.
 - I file `AGENTS.md` esistenti non vengono mai sovrascritti in silenzio: in TTY interattivo il setup chiede prima di sostituire; in modalità non interattiva la sostituzione viene saltata salvo `--force` (i controlli di sicurezza della sessione attiva restano validi).
@@ -204,7 +204,7 @@ Note:
 ## Agenti e Skill
 
 - Prompt: `prompts/*.md` (installati in `~/.codex/prompts/` per `user`, `./.codex/prompts/` per `project`)
-- Skill: `skills/*/SKILL.md` (installati in `~/.agents/skills/` per `user`, `./.agents/skills/` per `project`)
+- Skill: `skills/*/SKILL.md` (installati in `~/.codex/skills/` per `user`, `./.codex/skills/` per `project`)
 
 Esempi:
 - Agenti: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`

package/README.ja.md

@@ -54,7 +54,7 @@ User
   -> Codex CLI
     -> AGENTS.md (オーケストレーションブレイン)
     -> ~/.codex/prompts/*.md (エージェントプロンプトカタログ)
-    -> ~/.agents/skills/*/SKILL.md (スキルカタログ)
+    -> ~/.codex/skills/*/SKILL.md (スキルカタログ)
     -> ~/.codex/config.toml (機能、通知、MCP)
     -> .omx/ (ランタイム状態、メモリ、計画、ログ)
 ```
@@ -187,8 +187,8 @@ OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # オプション：適応型queue->resendフ
 
 - `.omx/setup-scope.json`（永続化されたセットアップスコープ）
 - スコープ依存のインストール：
-  - `user`：`~/.codex/prompts/`、`~/.agents/skills/`、`~/.codex/config.toml`、`~/.omx/agents/`、`~/.codex/AGENTS.md`
-  - `project`：`./.codex/prompts/`、`./.agents/skills/`、`./.codex/config.toml`、`./.omx/agents/`、`./AGENTS.md`
+  - `user`：`~/.codex/prompts/`、`~/.codex/skills/`、`~/.codex/config.toml`、`~/.omx/agents/`、`~/.codex/AGENTS.md`
+  - `project`：`./.codex/prompts/`、`./.codex/skills/`、`./.codex/config.toml`、`./.omx/agents/`、`./AGENTS.md`
 - 起動動作：永続化されたスコープが`project`の場合、`omx`起動時に自動的に`CODEX_HOME=./.codex`を使用（`CODEX_HOME`が既に設定されている場合を除く）。
 - 起動命令は`~/.codex/AGENTS.md`（または上書きされた`CODEX_HOME/AGENTS.md`）とプロジェクトの`./AGENTS.md`を結合し、その後ランタイムオーバーレイを追加して使用します。
 - 既存の`AGENTS.md`は黙って上書きされません。インタラクティブTTYでは置き換え前に確認し、非インタラクティブ実行では`--force`がない限り置き換えをスキップします（アクティブセッションの安全チェックは引き続き適用されます）。
@@ -205,7 +205,7 @@ OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # オプション：適応型queue->resendフ
 ## エージェントとスキル
 
 - プロンプト：`prompts/*.md`（`user`は`~/.codex/prompts/`に、`project`は`./.codex/prompts/`にインストール）
-- スキル：`skills/*/SKILL.md`（`user`は`~/.agents/skills/`に、`project`は`./.agents/skills/`にインストール）
+- スキル：`skills/*/SKILL.md`（`user`は`~/.codex/skills/`に、`project`は`./.codex/skills/`にインストール）
 
 例：
 - エージェント：`architect`、`planner`、`executor`、`debugger`、`verifier`、`security-reviewer`

package/README.ko.md

@@ -54,7 +54,7 @@ User
   -> Codex CLI
     -> AGENTS.md (오케스트레이션 브레인)
     -> ~/.codex/prompts/*.md (에이전트 프롬프트 카탈로그)
-    -> ~/.agents/skills/*/SKILL.md (스킬 카탈로그)
+    -> ~/.codex/skills/*/SKILL.md (스킬 카탈로그)
     -> ~/.codex/config.toml (기능, 알림, MCP)
     -> .omx/ (런타임 상태, 메모리, 계획, 로그)
 ```
@@ -187,8 +187,8 @@ OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # 선택: 적응형 queue->resend 폴백 비활
 
 - `.omx/setup-scope.json` (저장된 설정 범위)
 - 범위에 따른 설치:
-  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
+  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
+  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
 - 시작 동작: 저장된 범위가 `project`이면, `omx` 시작 시 자동으로 `CODEX_HOME=./.codex`를 사용합니다 (`CODEX_HOME`이 이미 설정되지 않은 경우).
 - 시작 지침은 `~/.codex/AGENTS.md`(또는 `CODEX_HOME/AGENTS.md`)와 프로젝트 `./AGENTS.md`를 병합한 뒤 런타임 오버레이를 추가해 사용합니다.
 - 기존 `AGENTS.md`는 자동으로 덮어쓰지 않습니다. 대화형 TTY 실행에서는 덮어쓸지 확인하고, 비대화형 실행에서는 `--force`가 없으면 건너뜁니다 (활성 세션 안전 검사는 여전히 적용됩니다).
@@ -205,7 +205,7 @@ OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # 선택: 적응형 queue->resend 폴백 비활
 ## 에이전트와 스킬
 
 - 프롬프트: `prompts/*.md` (`user`는 `~/.codex/prompts/`에, `project`는 `./.codex/prompts/`에 설치)
-- 스킬: `skills/*/SKILL.md` (`user`는 `~/.agents/skills/`에, `project`는 `./.agents/skills/`에 설치)
+- 스킬: `skills/*/SKILL.md` (`user`는 `~/.codex/skills/`에, `project`는 `./.codex/skills/`에 설치)
 
 예시:
 - 에이전트: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`

package/README.md

@@ -112,6 +112,7 @@ omx team 3:executor "ship the scoped task with verification"
 OMX treats default model selection as a small explicit contract:
 
 - `OMX_DEFAULT_FRONTIER_MODEL` — canonical frontier/default leader model
+- `OMX_DEFAULT_STANDARD_MODEL` — canonical standard subagent model
 - `OMX_DEFAULT_SPARK_MODEL` — canonical spark / low-complexity worker model
 
 If upstream defaults change, update the single canonical source instead of scattering model literals across prompts/docs/runtime.
@@ -122,6 +123,7 @@ For local-model setups, you can persist overrides in `~/.codex/.omx-config.json`
 {
   "env": {
     "OMX_DEFAULT_FRONTIER_MODEL": "your-frontier-model",
+    "OMX_DEFAULT_STANDARD_MODEL": "your-standard-model",
     "OMX_DEFAULT_SPARK_MODEL": "your-spark-model"
   }
 }
@@ -133,7 +135,7 @@ Resolution order:
 2. `.omx-config.json` `env` overrides
 3. OMX built-in canonical defaults
 
-The same config-driven env overrides are forwarded when OMX launches native helpers such as `omx sparkshell`, so local-model routing stays consistent.
+The same config-driven env overrides are forwarded when OMX launches native helpers such as `omx sparkshell`, so local-model routing stays consistent. By default OMX ships a three-lane split: frontier roles on `gpt-5.4`, standard subagents on `gpt-5.4-mini`, and spark/fast roles on `gpt-5.3-codex-spark`.
 
 Recommended trusted-environment launch profile:
 
@@ -204,7 +206,7 @@ User / Operator
     -> Codex CLI (execution engine)
     -> AGENTS.md (orchestration brain)
     -> ~/.codex/prompts/*.md (installable active/internal agent prompt catalog)
-    -> ~/.agents/skills/*/SKILL.md (skill catalog)
+    -> ~/.codex/skills/*/SKILL.md (skill catalog)
     -> ~/.codex/config.toml (features, notify, MCP)
     -> .omx/ (runtime state, memory, plans, logs)
 ```
@@ -267,6 +269,7 @@ omx team ...       # Start/status/resume/shutdown coordinated team workers (defa
 omx setup          # Install prompts/skills/config by scope + project .omx + scope-specific AGENTS.md
 omx agents-init .  # Bootstrap lightweight AGENTS.md files for a repo/subtree
 omx doctor         # Installation/runtime diagnostics
+omx cleanup        # Kill orphaned OMX MCP server processes (--dry-run to inspect)
 omx doctor --team  # Team Mode diagnostics
 omx ask ...        # Ask local provider advisor (claude|gemini), writes .omx/artifacts/*
 omx resume         # Resume a previous interactive Codex session
@@ -324,6 +327,10 @@ omx autoresearch missions/demo
 
 `omx autoresearch` now runs as a thin supervisor around one Codex experiment session at a time. A fresh launch creates a run-tagged `autoresearch/<slug>/<run-tag>` worktree lane, seeds the baseline evaluator row, writes authoritative per-run artifacts under `.omx/logs/autoresearch/<run-id>/`, and expects the session to hand back a repo-root `candidate.json` artifact. Each iteration's bootstrap instructions include the current baseline/last-kept state plus a bounded recent ledger summary, and `status=candidate` artifacts must point at the current worktree `HEAD` and last-kept base commit. After each session exit, OMX evaluates the candidate, records keep/discard/reset state, hard-resets discarded or ambiguous experiments back to the last kept commit, and relaunches the next iteration unless the run aborts. Use `omx autoresearch --resume <run-id>` to continue an existing run from its manifest/worktree.
 
+Autoresearch showcase:
+
+For the canonical autoresearch showcase — including completed research-style demos, missions, evaluators, and the lightweight runner script — see [`playground/README.md`](playground/README.md).
+
 `omx explore` is the default OMX surface for simple read-only exploration. It stays intentionally read-only and shell-only, and qualifying shell-native read-only tasks may be routed through `omx sparkshell` as a backend when that is the cheaper/more direct fit. The routing flag only adds advisory steering in generated session instructions; ambiguous or implementation-heavy requests stay on the normal Codex path, and OMX falls back normally if the explore harness is unavailable. The harness constrains Codex through a temporary allowlisted shell/bin layer so only approved repository-inspection command families are available during the offloaded run.
 
 - Current shell allowlist: `rg`, `grep`, `ls`, `find`, `wc`, `cat`, `head`, `tail`, `pwd`, `printf`
@@ -335,10 +342,10 @@ Packaging / install notes:
 
 - Published npm packages now include the Rust workspace files for the explore harness (`Cargo.toml`, `Cargo.lock`, `crates/`).
 - npm publishes no longer rely on publisher-platform native binaries.
-- Tagged releases build multi-platform native archives for both `omx-explore-harness` and `omx-sparkshell` via cargo-dist and attach them to the GitHub Release from `.github/workflows/release.yml`.
+- Tagged releases build multi-platform native archives for both `omx-explore-harness` and `omx-sparkshell` via cargo-dist and attach them to the GitHub Release from `.github/workflows/release.yml`, with Linux published from musl-first targets for broader runtime compatibility.
 - Runtime now prefers `OMX_*_BIN` overrides, then a hydrated per-user native cache, then repo-local development artifacts.
 - `omx explore` keeps a source-install `cargo run --manifest-path crates/omx-explore/Cargo.toml -- ...` fallback in repository checkouts; packaged installs rely on release-asset hydration unless `OMX_EXPLORE_BIN` is set.
-- `omx sparkshell` hydrates from release assets when no override or repo-local build output is available.
+- `omx sparkshell` hydrates from release assets when no override or repo-local build output is available; the release gate now proves that hydrated Linux assets still work in an older Dockerized Linux runtime before npm publish.
 - Release assets now include `native-release-manifest.json` with per-target download metadata and SHA-256 checksums.
 - Helpful local commands:
 
@@ -348,6 +355,7 @@ npm run build:explore
 npm run build:explore:release
 npm run test:explore
 node scripts/smoke-packed-install.mjs --release-assets-dir ./release-assets
+# release workflow also reruns the same smoke in node:20-bullseye as an older-Linux-runtime proof gate
 node scripts/check-version-sync.mjs --tag v$(node -p "require('./package.json').version")
 ```
 
@@ -569,8 +577,8 @@ Notes:
 
 - `.omx/setup-scope.json` (persisted setup scope)
 - Scope-dependent installs:
-  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
+  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
+  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
 - Launch behavior: if persisted scope is `project`, `omx` launch auto-uses `CODEX_HOME=./.codex` (unless `CODEX_HOME` is already set).
 - Launch instructions merge `~/.codex/AGENTS.md` (or `CODEX_HOME/AGENTS.md` when overridden) with project `./AGENTS.md`, then append the runtime overlay
 - Managed OMX artifacts refresh by default in both interactive and non-interactive runs: prompts, skills, native agent configs, and the managed OMX portion of `config.toml`
@@ -600,7 +608,7 @@ Notes:
 Use `omx agents-init [path]` when you only want a narrow AGENTS.md bootstrap helper instead of full OMX setup.
 
 - creates or refreshes `AGENTS.md` in the target directory plus its immediate child directories
-- skips generated/vendor/tooling directories such as `.git`, `.omx`, `.codex`, `.agents`, `node_modules`, `dist`, and `build`
+- skips generated/vendor/tooling directories such as `.git`, `.omx`, `.codex`, `node_modules`, `dist`, and `build`
 - preserves the `<!-- OMX:AGENTS-MANUAL:* -->` section on refresh
 - skips unmanaged existing `AGENTS.md` files unless you pass `--force`
 - does **not** install prompts, skills, config, or replace planning/execution workflows such as `team`, `ralph`, or `ralplan`
@@ -616,7 +624,7 @@ omx agents-init . --force
 ## Agents and Skills
 
 - Prompts: `prompts/*.md` (installed to `~/.codex/prompts/` for `user`, `./.codex/prompts/` for `project`)
-- Skills: `skills/*/SKILL.md` (installed to `~/.agents/skills/` for `user`, `./.agents/skills/` for `project`)
+- Skills: `skills/*/SKILL.md` (installed to `~/.codex/skills/` for `user`, `./.codex/skills/` for `project`)
 
 Examples:
 - Agents: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`

package/README.pt.md

@@ -53,7 +53,7 @@ User
   -> Codex CLI
     -> AGENTS.md (cérebro de orquestração)
     -> ~/.codex/prompts/*.md (catálogo de prompts de agentes)
-    -> ~/.agents/skills/*/SKILL.md (catálogo de skills)
+    -> ~/.codex/skills/*/SKILL.md (catálogo de skills)
     -> ~/.codex/config.toml (funcionalidades, notificações, MCP)
     -> .omx/ (estado de execução, memória, planos, logs)
 ```
@@ -186,8 +186,8 @@ Notas:
 
 - `.omx/setup-scope.json` (escopo de instalação persistido)
 - Instalações dependentes do escopo:
-  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
+  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
+  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
 - Comportamento de inicialização: se o escopo persistido for `project`, o lançamento do `omx` usa automaticamente `CODEX_HOME=./.codex` (a menos que `CODEX_HOME` já esteja definido).
 - As instruções de inicialização combinam `~/.codex/AGENTS.md` (ou `CODEX_HOME/AGENTS.md`, quando sobrescrito) com o `./AGENTS.md` do projeto e depois adicionam o overlay de runtime.
 - Arquivos `AGENTS.md` existentes nunca são sobrescritos silenciosamente: em TTY interativo o setup pergunta antes de substituir; em modo não interativo a substituição é ignorada, a menos que você use `--force` (verificações de segurança de sessões ativas continuam valendo).
@@ -204,7 +204,7 @@ Notas:
 ## Agentes e skills
 
 - Prompts: `prompts/*.md` (instalados em `~/.codex/prompts/` para `user`, `./.codex/prompts/` para `project`)
-- Skills: `skills/*/SKILL.md` (instalados em `~/.agents/skills/` para `user`, `./.agents/skills/` para `project`)
+- Skills: `skills/*/SKILL.md` (instalados em `~/.codex/skills/` para `user`, `./.codex/skills/` para `project`)
 
 Exemplos:
 - Agentes: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`

package/README.ru.md

@@ -53,7 +53,7 @@ User
   -> Codex CLI
     -> AGENTS.md (мозг оркестрации)
     -> ~/.codex/prompts/*.md (каталог промптов агентов)
-    -> ~/.agents/skills/*/SKILL.md (каталог навыков)
+    -> ~/.codex/skills/*/SKILL.md (каталог навыков)
     -> ~/.codex/config.toml (функции, уведомления, MCP)
     -> .omx/ (состояние выполнения, память, планы, журналы)
 ```
@@ -186,8 +186,8 @@ OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # опционально: отключить а
 
 - `.omx/setup-scope.json` (сохранённая область установки)
 - Установки в зависимости от области:
-  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
+  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
+  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
 - Поведение при запуске: если сохранённая область — `project`, `omx` автоматически использует `CODEX_HOME=./.codex` (если `CODEX_HOME` ещё не задан).
 - Инструкции запуска объединяют `~/.codex/AGENTS.md` (или `CODEX_HOME/AGENTS.md`, если путь переопределён) с проектным `./AGENTS.md`, а затем добавляют runtime-overlay.
 - Существующие файлы `AGENTS.md` никогда не перезаписываются молча: в интерактивном TTY setup спрашивает перед заменой, а в неинтерактивном режиме пропускает замену без `--force` (проверки безопасности активных сессий остаются в силе).
@@ -204,7 +204,7 @@ OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # опционально: отключить а
 ## Агенты и навыки
 
 - Промпты: `prompts/*.md` (устанавливаются в `~/.codex/prompts/` для `user`, `./.codex/prompts/` для `project`)
-- Навыки: `skills/*/SKILL.md` (устанавливаются в `~/.agents/skills/` для `user`, `./.agents/skills/` для `project`)
+- Навыки: `skills/*/SKILL.md` (устанавливаются в `~/.codex/skills/` для `user`, `./.codex/skills/` для `project`)
 
 Примеры:
 - Агенты: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`

package/README.tr.md

@@ -53,7 +53,7 @@ User
   -> Codex CLI
     -> AGENTS.md (orkestrasyon beyni)
     -> ~/.codex/prompts/*.md (ajan prompt kataloğu)
-    -> ~/.agents/skills/*/SKILL.md (skill kataloğu)
+    -> ~/.codex/skills/*/SKILL.md (skill kataloğu)
     -> ~/.codex/config.toml (özellikler, bildirimler, MCP)
     -> .omx/ (çalışma zamanı durumu, bellek, planlar, günlükler)
 ```
@@ -186,8 +186,8 @@ Notlar:
 
 - `.omx/setup-scope.json` (kalıcı kurulum kapsamı)
 - Kapsama bağlı kurulumlar:
-  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
+  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
+  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
 - Başlatma davranışı: kalıcı kapsam `project` ise, `omx` başlatma otomatik olarak `CODEX_HOME=./.codex` kullanır (`CODEX_HOME` zaten ayarlanmadıysa).
 - Başlatma talimatları `~/.codex/AGENTS.md` (veya geçersiz kılındıysa `CODEX_HOME/AGENTS.md`) ile proje `./AGENTS.md` dosyasını birleştirir ve ardından çalışma zamanı kaplamasını ekler.
 - Mevcut `AGENTS.md` dosyaları sessizce üzerine yazılmaz: etkileşimli TTY'de setup değiştirmeden önce sorar; etkileşimsiz çalıştırmada ise `--force` yoksa değiştirme atlanır (aktif oturum güvenlik kontrolleri hâlâ geçerlidir).
@@ -204,7 +204,7 @@ Notlar:
 ## Ajanlar ve Skill'ler
 
 - Prompt'lar: `prompts/*.md` (`user` için `~/.codex/prompts/`'a, `project` için `./.codex/prompts/`'a kurulur)
-- Skill'ler: `skills/*/SKILL.md` (`user` için `~/.agents/skills/`'a, `project` için `./.agents/skills/`'a kurulur)
+- Skill'ler: `skills/*/SKILL.md` (`user` için `~/.codex/skills/`'a, `project` için `./.codex/skills/`'a kurulur)
 
 Örnekler:
 - Ajanlar: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`

package/README.vi.md

@@ -54,7 +54,7 @@ User
   -> Codex CLI
     -> AGENTS.md (bộ não điều phối)
     -> ~/.codex/prompts/*.md (danh mục prompt tác nhân)
-    -> ~/.agents/skills/*/SKILL.md (danh mục skill)
+    -> ~/.codex/skills/*/SKILL.md (danh mục skill)
     -> ~/.codex/config.toml (tính năng, thông báo, MCP)
     -> .omx/ (trạng thái runtime, bộ nhớ, kế hoạch, nhật ký)
 ```
@@ -187,8 +187,8 @@ Lưu ý:
 
 - `.omx/setup-scope.json` (phạm vi cài đặt được lưu trữ)
 - Cài đặt phụ thuộc phạm vi:
-  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
+  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
+  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
 - Hành vi khởi chạy: nếu phạm vi được lưu trữ là `project`, khởi chạy `omx` tự động sử dụng `CODEX_HOME=./.codex` (trừ khi `CODEX_HOME` đã được đặt).
 - Hướng dẫn khởi chạy sẽ kết hợp `~/.codex/AGENTS.md` (hoặc `CODEX_HOME/AGENTS.md` nếu đã ghi đè) với `./AGENTS.md` của dự án, rồi thêm lớp phủ runtime.
 - Các tệp `AGENTS.md` hiện có sẽ không bao giờ bị ghi đè âm thầm: ở TTY tương tác, setup hỏi trước khi thay thế; ở chế độ không tương tác, việc thay thế sẽ bị bỏ qua trừ khi dùng `--force` (kiểm tra an toàn phiên hoạt động vẫn áp dụng).
@@ -205,7 +205,7 @@ Lưu ý:
 ## Tác nhân và skill
 
 - Prompt: `prompts/*.md` (cài vào `~/.codex/prompts/` cho `user`, `./.codex/prompts/` cho `project`)
-- Skill: `skills/*/SKILL.md` (cài vào `~/.agents/skills/` cho `user`, `./.agents/skills/` cho `project`)
+- Skill: `skills/*/SKILL.md` (cài vào `~/.codex/skills/` cho `user`, `./.codex/skills/` cho `project`)
 
 Ví dụ:
 - Tác nhân: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`

package/README.zh-TW.md

@@ -54,7 +54,7 @@ OMX 安裝並串接以下各層：
   -> Codex CLI
     -> AGENTS.md（編排大腦）
     -> ~/.codex/prompts/*.md（代理提示詞目錄）
-    -> ~/.agents/skills/*/SKILL.md（技能目錄）
+    -> ~/.codex/skills/*/SKILL.md（技能目錄）
     -> ~/.codex/config.toml（功能、通知、MCP）
     -> .omx/（執行期狀態、記憶、計畫、日誌）
 ```
@@ -206,8 +206,8 @@ OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # 選用：停用自適應 queue->resend 回退
 
 - `.omx/setup-scope.json`（持久化的設定範圍）
 - 依範圍的安裝內容：
-  - `user`：`~/.codex/prompts/`、`~/.agents/skills/`、`~/.codex/config.toml`、`~/.omx/agents/`、`~/.codex/AGENTS.md`
-  - `project`：`./.codex/prompts/`、`./.agents/skills/`、`./.codex/config.toml`、`./.omx/agents/`、`./AGENTS.md`
+  - `user`：`~/.codex/prompts/`、`~/.codex/skills/`、`~/.codex/config.toml`、`~/.omx/agents/`、`~/.codex/AGENTS.md`
+  - `project`：`./.codex/prompts/`、`./.codex/skills/`、`./.codex/config.toml`、`./.omx/agents/`、`./AGENTS.md`
 - 啟動行為：若持久化範圍為 `project`，`omx` 啟動時自動使用 `CODEX_HOME=./.codex`（除非已設定 `CODEX_HOME`）。
 - 啟動指令會合併 `~/.codex/AGENTS.md`（或覆寫後的 `CODEX_HOME/AGENTS.md`）與專案 `./AGENTS.md`，然後再附加執行期 overlay。
 - 現有的 `AGENTS.md` 檔案絕不會被靜默覆寫：互動式 TTY 執行時 setup 會先詢問；非互動執行時若沒有 `--force` 就會跳過替換（仍適用活動會話安全檢查）。
@@ -224,7 +224,7 @@ OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # 選用：停用自適應 queue->resend 回退
 ## 代理與技能
 
 - 提示詞：`prompts/*.md`（`user` 安裝至 `~/.codex/prompts/`，`project` 安裝至 `./.codex/prompts/`）
-- 技能：`skills/*/SKILL.md`（`user` 安裝至 `~/.agents/skills/`，`project` 安裝至 `./.agents/skills/`）
+- 技能：`skills/*/SKILL.md`（`user` 安裝至 `~/.codex/skills/`，`project` 安裝至 `./.codex/skills/`）
 
 範例：
 - 代理：`architect`、`planner`、`executor`、`debugger`、`verifier`、`security-reviewer`