oh-my-codex 0.11.11 → 0.11.13

package/README.md

@@ -18,10 +18,33 @@ OMX is a workflow layer for [OpenAI Codex CLI](https://github.com/openai/codex).
 
 It keeps Codex as the execution engine and makes it easier to:
 - start a stronger Codex session by default
-- reuse good role/task invocations with `$name` keywords
-- invoke workflows with skills like `$plan`, `$ralph`, and `$team`
+- run one consistent workflow from clarification to completion
+- invoke the canonical skills with `$deep-interview`, `$ralplan`, `$team`, and `$ralph`
 - keep project guidance, plans, logs, and state in `.omx/`
 
+## Core Maintainers
+
+| Role | Name | GitHub |
+| --- | --- | --- |
+| Creator & Lead | Yeachan Heo | [@Yeachan-Heo](https://github.com/Yeachan-Heo) |
+| Maintainer | HaD0Yun | [@HaD0Yun](https://github.com/HaD0Yun) |
+
+## Ambassadors
+
+| Name | GitHub |
+| --- | --- |
+| Sigrid Jin | [@sigridjineth](https://github.com/sigridjineth) |
+
+## Top Collaborators
+
+| Name | GitHub |
+| --- | --- |
+| HaD0Yun | [@HaD0Yun](https://github.com/HaD0Yun) |
+| Junho Yeo | [@junhoyeo](https://github.com/junhoyeo) |
+| JiHongKim98 | [@JiHongKim98](https://github.com/JiHongKim98) |
+| Lor | — |
+| HyunjunJeon | [@HyunjunJeon](https://github.com/HyunjunJeon) |
+
 ## Recommended default flow
 
 If you want the default OMX experience, start here:
@@ -35,18 +58,20 @@ omx --madmax --high
 Then work normally inside Codex:
 
 ```text
-$architect "analyze the authentication flow"
-$plan "ship this feature cleanly"
+$deep-interview "clarify the authentication change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
 That is the main path.
-Start OMX strongly, do the work in Codex, and let the agent pull in `$team` or other workflows only when the task actually needs them.
+Start OMX strongly, clarify first when needed, approve the plan, then choose `$team` for coordinated parallel execution or `$ralph` for the persistent completion loop.
 
 ## What OMX is for
 
 Use OMX if you already like Codex and want a better day-to-day runtime around it:
-- reusable role/task invocations such as `$architect` and `$executor`
-- reusable workflows such as `$plan`, `$ralph`, `$team`, and `$deep-interview`
+- a standard workflow built around `$deep-interview`, `$ralplan`, `$team`, and `$ralph`
+- specialist roles and supporting skills when the task needs them
 - project guidance through scoped `AGENTS.md`
 - durable state under `.omx/` for plans, logs, memory, and mode tracking
 
@@ -70,14 +95,16 @@ Launch OMX the recommended way:
 omx --madmax --high
 ```
 
-Then try one role keyword and one workflow skill:
+Then try the canonical workflow:
 
 ```text
-$architect "analyze the authentication flow"
-$plan "map the safest implementation path"
+$deep-interview "clarify the authentication change"
+$ralplan "approve the safest implementation path"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
-If the task grows, the agent can escalate to heavier workflows such as `$ralph` for persistent execution or `$team` for coordinated parallel work.
+Use `$team` when the approved plan needs coordinated parallel work, or `$ralph` when one persistent owner should keep pushing to completion.
 
 ## A simple mental model
 
@@ -95,27 +122,26 @@ Most users should think of OMX as **better task routing + better workflow + bett
 
 1. Run `omx setup`
 2. Launch with `omx --madmax --high`
-3. Ask for analysis with `$architect "..."`
-4. Ask for planning with `$plan "..."`
-5. Let the agent decide when `$ralph`, `$team`, or another workflow is worth using
+3. Use `$deep-interview "..."` when the request or boundaries are still unclear
+4. Use `$ralplan "..."` to approve the plan and review tradeoffs
+5. Choose `$team` for coordinated parallel execution or `$ralph` for persistent completion loops
+
+## Recommended workflow
+
+1. `$deep-interview` — clarify scope when the request or boundaries are still vague.
+2. `$ralplan` — turn that clarified scope into an approved architecture and implementation plan.
+3. `$team` or `$ralph` — use `$team` for coordinated parallel execution, or `$ralph` when you want a persistent completion loop with one owner.
 
 ## Common in-session surfaces
 
 | Surface | Use it for |
 | --- | --- |
-| `$architect "..."` | analysis, boundaries, tradeoffs |
-| `$executor "..."` | focused implementation work |
-| `/skills` | browsing installed skills |
-| `$plan "..."` | planning before implementation |
-| `$ralph "..."` | persistent sequential execution |
-| `$team "..."` | coordinated parallel execution when the task is big enough |
-
-Use `$deep-interview` when the request is still vague, the boundaries are unclear, or you want OMX to keep pressing on intent, non-goals, and decision boundaries before it hands work off to `$plan`, `$ralph`, `$team`, or `$autopilot`.
-
-Typical cases:
-- vague greenfield ideas that still need sharper intent and scope
-- brownfield changes where OMX should inspect the repo first, then ask cited confirmation questions
-- requests where you want a one-question-at-a-time clarification loop instead of immediate planning or implementation
+| `$deep-interview "..."` | clarifying intent, boundaries, and non-goals |
+| `$ralplan "..."` | approving the implementation plan and tradeoffs |
+| `$ralph "..."` | persistent completion and verification loops |
+| `$team "..."` | coordinated parallel execution when the work is big enough |
+| `/skills` | browsing installed skills and supporting helpers |
+
 ## Advanced / operator surfaces
 
 These are useful, but they are not the main onboarding path.
@@ -201,6 +227,8 @@ If this happens, try:
 - [Deutsch](./README.de.md)
 - [Français](./README.fr.md)
 - [Italiano](./README.it.md)
+- [Ελληνικά](./README.el.md)
+- [Polski](./README.pl.md)
 
 ## Contributors
 
@@ -215,4 +243,4 @@ If this happens, try:
 
 ## License
 
-MIT
+MIT

package/README.pl.md

@@ -0,0 +1,216 @@
+# oh-my-codex (OMX)
+
+<p align="center">
+  <img src="https://yeachan-heo.github.io/oh-my-codex-website/omx-character-nobg.png" alt="postać oh-my-codex" width="280">
+  <br>
+  <em>Zacznij z Codexem jak zwykle. Gdy projekt urośnie — niech OMX wesprze resztę.</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)
+[![Discord](https://img.shields.io/discord/1452487457085063218?color=5865F2&logo=discord&logoColor=white&label=Discord)](https://discord.gg/PUwSMR9XNk)
+
+**Strona:** https://yeachan-heo.github.io/oh-my-codex-website/
+**Dokumentacja:** [Pierwsze kroki](./docs/getting-started.html) · [Agenty](./docs/agents.html) · [Skille](./docs/skills.html) · [Integracje](./docs/integrations.html) · [Demo](./DEMO.md) · [Przewodnik po OpenClaw](./docs/openclaw-integration.md)
+
+OMX to nakładka na [OpenAI Codex CLI](https://github.com/openai/codex).
+
+Codex zostaje silnikiem, który wykonuje pracę. OMX daje mu lepszy kontekst, gotowe role i cykle pracy — żebyś nie zaczynał od zera przy każdej sesji. Konkretnie:
+- lepsza sesja Codexa od pierwszego uruchomienia
+- wielokrotne użycie ról i zadań przez słowa kluczowe `$name`
+- gotowe cykle pracy: `$plan`, `$ralph`, `$team`
+- plany, logi, pamięć i stan trzymane w `.omx/`
+
+## Jak zacząć
+
+Jeśli chcesz po prostu zacząć:
+
+```bash
+npm install -g @openai/codex oh-my-codex
+omx setup
+omx --madmax --high
+```
+
+Potem pracuj normalnie w Codexie:
+
+```text
+$architect "analyze the authentication flow"
+$plan "ship this feature cleanly"
+```
+
+To jest główna ścieżka. Uruchom OMX, wykonaj pracę w Codexie i pozwól agentowi sięgać po `$team` lub inne cykle pracy tylko wtedy, gdy zadanie naprawdę tego wymaga.
+
+## Do czego służy OMX
+
+Używaj OMX, jeśli lubisz Codexa i chcesz mieć wokół niego lepsze środowisko pracy:
+- wielokrotne role i zadania: `$architect`, `$executor`
+- gotowe cykle pracy: `$plan`, `$ralph`, `$team`, `$deep-interview`
+- wytyczne projektu przez `AGENTS.md`
+- trwały stan w `.omx/`
+
+Jeśli chcesz czystego Codexa bez żadnych dodatków, OMX pewnie nie jest dla Ciebie.
+
+## Szybki start
+
+### Wymagania
+
+- Node.js 20+
+- Codex CLI: `npm install -g @openai/codex`
+- Skonfigurowane uwierzytelnianie Codex
+- `tmux` na macOS/Linux — jeśli planujesz używać trybu zespołowego
+- `psmux` na natywnym Windows — jeśli planujesz używać trybu zespołowego
+
+### Dobra pierwsza sesja
+
+```bash
+omx --madmax --high
+```
+
+Potem wypróbuj jedną rolę i jeden skill:
+
+```text
+$architect "analyze the authentication flow"
+$plan "map the safest implementation path"
+```
+
+Jeśli zadanie urośnie, agent może sam zdecydować o użyciu `$ralph` albo `$team`.
+
+## Jak o tym myśleć
+
+OMX **nie** zastępuje Codexa.
+
+To warstwa, która go otacza:
+- **Codex** wykonuje właściwą pracę
+- **Role OMX** sprawiają, że przydatne role są wielokrotnego użytku
+- **Skille OMX** dają gotowe cykle pracy
+- **`.omx/`** przechowuje plany, logi, pamięć i stan
+
+OMX to lepsze kierowanie zadaniami i gotowe cykle pracy — nie kolejna rzecz do klikania przez cały dzień.
+
+## Zacznij tutaj, jeśli jesteś nowy
+
+1. Uruchom `omx setup`
+2. Wystartuj z `omx --madmax --high`
+3. Poproś o analizę: `$architect "..."`
+4. Poproś o plan: `$plan "..."`
+5. Pozwól agentowi zdecydować, kiedy użyć `$ralph`, `$team` albo czegoś innego
+
+## Co możesz robić podczas sesji
+
+| Komenda | Do czego służy |
+| --- | --- |
+| `$architect "..."` | analiza, granice, kompromisy |
+| `$executor "..."` | skupiona praca implementacyjna |
+| `/skills` | lista zainstalowanych skilli |
+| `$plan "..."` | planowanie przed implementacją |
+| `$ralph "..."` | długie zadania krok po kroku |
+| `$team "..."` | równoległa praca kilku agentów, gdy zadanie tego wymaga |
+
+`$deep-interview` przydaje się, gdy prośba jest niejasna — OMX będzie dopytywał o intencję, zakres i granice decyzji, zanim przekaże pracę dalej do `$plan`, `$ralph`, `$team` albo `$autopilot`.
+
+Kiedy to ma sens:
+- masz pomysł na nowy projekt, ale jeszcze nie wiesz dokładnie, czego chcesz
+- chcesz, żeby OMX najpierw przejrzał repo, a dopiero potem zadał pytania z konkretnymi cytatami
+- wolisz doprecyzowywać po jednym pytaniu naraz zamiast od razu planować
+
+## Zaawansowane / dla operatorów
+
+Poniższe funkcje są przydatne, ale nie są główną ścieżką.
+
+### Tryb zespołowy
+
+Używaj trybu zespołowego, gdy konkretnie potrzebujesz trwałej koordynacji z tmuxem i gałęziami roboczymi — nie jako domyślnego sposobu pracy z OMX.
+
+```bash
+omx team 3:executor "fix the failing tests with verification"
+omx team status <team-name>
+omx team resume <team-name>
+omx team shutdown <team-name>
+```
+
+### Setup, doctor i HUD
+
+- `omx setup` — instaluje prompty, skille, konfigurację i strukturę plików AGENTS
+- `omx doctor` — sprawdza instalację, gdy coś nie działa
+- `omx hud --watch` — podgląd stanu i postępu, nie główny cykl pracy
+
+### Explore i sparkshell
+
+- `omx explore --prompt "..."` — przeszukuje repo tylko do odczytu
+- `omx sparkshell <command>` — inspekcja w shellu i ograniczona weryfikacja
+
+Przykłady:
+
+```bash
+omx explore --prompt "find where team state is written"
+omx sparkshell git status
+omx sparkshell --tmux-pane %12 --tail-lines 400
+```
+
+### Wymagania platformowe dla trybu zespołowego
+
+`omx team` wymaga tmux lub odpowiednika:
+
+| Platforma | Instalacja |
+| --- | --- |
+| macOS | `brew install tmux` |
+| Ubuntu/Debian | `sudo apt install tmux` |
+| Fedora | `sudo dnf install tmux` |
+| Arch | `sudo pacman -S tmux` |
+| Windows | `winget install psmux` |
+| Windows (WSL2) | `sudo apt install tmux` |
+
+## Znane problemy
+
+### Intel Mac: wysokie użycie CPU przez `syspolicyd` / `trustd` podczas uruchamiania
+
+Na niektórych komputerach Intel Mac uruchamianie OMX — zwłaszcza z `--madmax --high` — może powodować skok użycia CPU przez `syspolicyd` i `trustd`. Dzieje się tak, gdy macOS Gatekeeper weryfikuje wiele procesów naraz.
+
+Jeśli to widzisz:
+- `xattr -dr com.apple.quarantine $(which omx)`
+- dodaj terminal do listy Developer Tools w ustawieniach bezpieczeństwa macOS
+- ogranicz współbieżność, np. unikając `--madmax --high`
+
+## Dokumentacja
+
+- [Pierwsze kroki](./docs/getting-started.html)
+- [Przewodnik po demo](./DEMO.md)
+- [Katalog agentów](./docs/agents.html)
+- [Dokumentacja skilli](./docs/skills.html)
+- [Integracje](./docs/integrations.html)
+- [Przewodnik po OpenClaw / bramce powiadomień](./docs/openclaw-integration.md)
+- [Współtworzenie](./CONTRIBUTING.md)
+- [Dziennik zmian](./CHANGELOG.md)
+
+## Języki
+
+- [English](./README.md)
+- [한국어](./README.ko.md)
+- [日本語](./README.ja.md)
+- [简体中文](./README.zh.md)
+- [繁體中文](./README.zh-TW.md)
+- [Tiếng Việt](./README.vi.md)
+- [Español](./README.es.md)
+- [Português](./README.pt.md)
+- [Русский](./README.ru.md)
+- [Türkçe](./README.tr.md)
+- [Deutsch](./README.de.md)
+- [Français](./README.fr.md)
+- [Italiano](./README.it.md)
+- [Polski](./README.pl.md)
+
+## Współtwórcy
+
+| Rola | Imię i nazwisko | GitHub |
+| --- | --- | --- |
+| Twórca i lider | Yeachan Heo | [@Yeachan-Heo](https://github.com/Yeachan-Heo) |
+| Maintainer | HaD0Yun | [@HaD0Yun](https://github.com/HaD0Yun) |
+
+## Historia gwiazdek
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Yeachan-Heo/oh-my-codex&type=date&legend=top-left)](https://www.star-history.com/#Yeachan-Heo/oh-my-codex&type=date&legend=top-left)
+
+## Licencja
+
+MIT

package/README.pt.md

@@ -30,10 +30,10 @@ Veja também as [notas de release da v0.9.0](./docs/release-notes-0.9.0.md) e o
 Dentro do 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"
+$deep-interview "clarify the auth change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
 Do terminal:
@@ -44,6 +44,12 @@ omx team status <team-name>
 omx team shutdown <team-name>
 ```
 
+## Fluxo recomendado
+
+1. `$deep-interview` — quando escopo ou limites ainda não estão claros.
+2. `$ralplan` — para transformar esse escopo esclarecido em um plano aprovado de arquitetura e implementação.
+3. `$team` ou `$ralph` — use `$team` para execução paralela coordenada, ou `$ralph` para um loop persistente de conclusão/verificação com um único responsável.
+
 ## Modelo central
 
 OMX instala e conecta estas camadas:
@@ -155,7 +161,7 @@ Regra importante: não encerre enquanto tarefas estiverem em estado `in_progress
 ### Team shutdown policy
 
 Use `omx team shutdown <team-name>` after the team reaches a terminal state.
-Team cleanup now follows one standalone path; there is no separate `omx team ralph ...` shutdown policy anymore.
+Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
 
 Seleção de Worker CLI para workers da equipe:
 
@@ -199,7 +205,7 @@ Notas:
 
 Exemplos:
 - Agentes: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
-- Skills: `autopilot`, `plan`, `team`, `ralph`, `ultrawork`, `cancel`
+- Skills: `deep-interview`, `ralplan`, `team`, `ralph`, `plan`, `cancel`
 
 ## Estrutura do projeto
 

package/README.ru.md

@@ -30,10 +30,10 @@ Spark Initiative — это релиз, усиливающий нативный
 Внутри 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"
+$deep-interview "clarify the auth change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
 Из терминала:
@@ -44,6 +44,12 @@ omx team status <team-name>
 omx team shutdown <team-name>
 ```
 
+## Рекомендуемый рабочий процесс
+
+1. `$deep-interview` — когда объём задачи или границы ещё не прояснены.
+2. `$ralplan` — чтобы превратить уточнённый объём в согласованный план архитектуры и реализации.
+3. `$team` или `$ralph` — используйте `$team` для координированного параллельного выполнения, а `$ralph` — для настойчивого цикла доведения до конца и проверки с одним ответственным.
+
 ## Базовая модель
 
 OMX устанавливает и связывает следующие слои:
@@ -155,7 +161,7 @@ omx team shutdown <team-name>
 ### Team shutdown policy
 
 Use `omx team shutdown <team-name>` after the team reaches a terminal state.
-Team cleanup now follows one standalone path; there is no separate `omx team ralph ...` shutdown policy anymore.
+Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
 
 Выбор Worker CLI для рабочих команды:
 
@@ -199,7 +205,7 @@ OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # опционально: отключить а
 
 Примеры:
 - Агенты: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
-- Навыки: `autopilot`, `plan`, `team`, `ralph`, `ultrawork`, `cancel`
+- Навыки: `deep-interview`, `ralplan`, `team`, `ralph`, `plan`, `cancel`
 
 ## Структура проекта
 

package/README.tr.md

@@ -30,10 +30,10 @@ Ayrıntılar için [v0.9.0 release notları](./docs/release-notes-0.9.0.md) ve [
 Codex içinde:
 
 ```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"
+$deep-interview "clarify the auth change"
+$ralplan "approve the auth plan and review tradeoffs"
+$ralph "carry the approved plan to completion"
+$team 3:executor "execute the approved plan in parallel"
 ```
 
 Terminalden:
@@ -44,6 +44,12 @@ omx team status <team-name>
 omx team shutdown <team-name>
 ```
 
+## Önerilen iş akışı
+
+1. `$deep-interview` — kapsam veya sınırlar hâlâ net değilse.
+2. `$ralplan` — netleşen kapsamı onaylanmış bir mimari ve uygulama planına dönüştürmek için.
+3. `$team` veya `$ralph` — koordineli paralel yürütme için `$team`, tek sahipli kalıcı tamamlama/doğrulama döngüsü için `$ralph` kullanın.
+
 ## Temel Model
 
 OMX şu katmanları kurar ve bağlar:
@@ -155,7 +161,7 @@ omx team shutdown <team-name>
 ### Team shutdown policy
 
 Use `omx team shutdown <team-name>` after the team reaches a terminal state.
-Team cleanup now follows one standalone path; there is no separate `omx team ralph ...` shutdown policy anymore.
+Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
 
 Takım çalışanları için Worker CLI seçimi:
 
@@ -199,7 +205,7 @@ Notlar:
 
 Örnekler:
 - Ajanlar: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
-- Skill'ler: `autopilot`, `plan`, `team`, `ralph`, `ultrawork`, `cancel`
+- Skill'ler: `deep-interview`, `ralplan`, `team`, `ralph`, `plan`, `cancel`
 
 ## Proje Yapısı