Oh My codeX — параллельные агенты для Codex CLI, tmux worktrees и HUD, который показывает, что делает каждый бот
У обычного Codex CLI от OpenAI ровно один режим работы: ты запускаешь сессию, пишешь промпт, смотришь как один агент пыхтит над задачей. Захочешь параллелить, открывай три терминала руками, копируй контекст между ними, молись, чтобы они не перезаписали друг другу файлы. Это ровно то, от чего избавляются Claude Code-пользователи через Superpowers и Agent Teams.
Оказывается, у Codex теперь тоже есть свой оркестратор. Называется oh-my-codex, сокращённо OMX, и описывается автором как "oh-my-zsh для Codex". 23 тысячи звёзд на GitHub, 2 тысячи форков, 14-я версия вышла на этой неделе. Репо от разработчика Yeachan-Heo, лицензия MIT, ставится одной командой из npm.
TL;DR: OMX — обёртка над Codex CLI, которая добавляет 33 агентских промпта, 36 воркфлоу-скиллов, tmux-параллельность с автоматической git-изоляцией и живой HUD. Codex остаётся движком, OMX становится маршрутизатором задач. Ставится за 2 минуты, но версии 0.13 и 0.14 ещё сырые, и баги с падением при запуске ловят прямо сейчас.
В чём суть
OMX не заменяет Codex и не форкает его. Он оборачивает сессию, инжектит в неё каталог из 33 специализированных промптов (архитектор, security-reviewer, executor, researcher и прочие) и каталог из 36 скиллов, которые выглядят как команды с префиксом $. Codex продолжает делать всю реальную работу, OMX даёт ему структуру.
Канонический воркфлоу — четыре шага:
$deep-interview "..."— уточняет границы задачи. Классификация намерения до того, как Codex начнёт писать план.$ralplan "..."— строит план с разбором тредоффов и требует твоего явного апрува перед запуском.$ralph "..."— "boulder never stops rolling". Цикл, который докатывает одобренный план до верифицированного done и восстанавливается после ошибок сам.$team N:executor "..."— параллельное выполнение на N воркерах, каждый в своём git worktree.
Между шагами OMX ведёт .omx/ директорию: планы, логи, notepad для памяти и project-memory.json для фактов, которые должны пережить context pruning. Это ровно тот слой, которого в vanilla Codex нет. Там вся память умирает с сессией.
Как поставить за две минуты
Минимум:
npm install -g @openai/codex oh-my-codex omx setup omx doctor
omx setup делает семь шагов: создаёт директории, ставит 33 промпта в ~/.codex/prompts/, 36 скиллов в ~/.codex/skills/, обновляет ~/.codex/config.toml, поднимает 5 MCP-серверов (state, memory, code-intel, trace, team-comm), генерит AGENTS.md в корне проекта, вешает notification-хук и настраивает HUD.
После этого omx doctor покажет чеклист из 9 проверок. Дальше запускаешь сессию:
omx --madmax --high
Флаги --madmax --high — это рекомендованные настройки для доверенного окружения: максимальный reasoning effort и ослабленные ограничения на тулы. Без них получишь стандартную Codex-сессию с доступными OMX-командами, но без агрессивного режима работы.
Параллельность, которую сложно сломать
Самое интересное в OMX — это $team. Команда спавнит N tmux-панелей, в каждой запускает Codex-сессию, создаёт под каждую git worktree по пути .omx/team/<name>/worktrees/worker-N и раздаёт задачи.
$team 3:executor "refactor auth module from sessions to JWT"
Ты получаешь три параллельных Codex-воркера. Каждый пишет в отдельную detached-ветку. Лидер инкрементально мёржит готовые ветки через git merge --no-ff -X theirs или cherry-pick, конфликты складывает в integration-report.md. Воркеры, которые закончили раньше, подхватывают следующие задачи из очереди без ручной координации.
Можно смешивать провайдеров:
OMX_TEAM_WORKER_CLI_MAP=codex,claude,gemini \ omx team 3:executor "full-stack feature implementation"
Это редкий случай, когда разные CLI-агенты работают над одним репо в изоляции и не переписывают друг другу файлы. Claude Code может делать фронт, Codex — бэк, а тесты уходят Gemini. Каждый сидит в своём worktree, поэтому коллизии физически невозможны. Лично меня зацепил именно этот кейс: у меня стоят все три CLI, но гонять их на одном репо одновременно всегда было головной болью.
Живой мониторинг через HUD:
omx hud --watch
Это не основной сюрфейс, а операторский. Но когда у тебя гудит 3-6 воркеров одновременно, без HUD ты теряешь нить того, кто где застрял.
Что реально работает из коробки
После omx setup в сессии доступно 13 основных скиллов: $architect, $executor, $reviewer, $plan, $research, $team, $review, $tdd, $ultrawork, $ultraqa, $deep-interview, $doctor, $hud.
Пример code review на существующий модуль:
> $security-reviewer "review the API endpoints"
OMX выдаёт анализ по OWASP Top 10 с приоритизацией severity и remediation-кодом. Не потому что Codex стал умнее, а потому что промпт в $security-reviewer это 200-строчная инструкция с чеклистом.
Или структурный поиск:
> $explore "find all database query patterns"
Уже не простой grep. За $explore стоят AST-инструменты (через MCP omx_code_intel), LSP-команды для definitions/references/symbols и семантическое сужение.
На длинных рефакторах выручает $ralph. Лог одного раута: 40+ итераций, каждая вида "запустил тесты, нашёл ошибку, пофиксил, снова запустил". Без OMX это требует ручного пинания агента. С OMX один раз сказал "докати до зелёных тестов", пошёл спать.
Подводные камни
Версии 0.13.0 и 0.14.0 сырые. В issue #1627 от 16 апреля зарепортили краш после апгрейда: omx --madmax --high вылетает немедленно. Issue висит открытой. Плюс 17 апреля в #1635 всплыло, что при запуске child-сессий лидер может зависать на startup-экране omx_state MCP, хотя дочерние воркеры реально работают. Если хочешь стабильности, откатывайся на 0.12.x или жди 0.14.1.
Team mode на macOS arm64 нестабилен. В #1449 от 10 апреля разработчик воспроизвёл сценарий, где воркеры запускаются, стартовый промпт долетает, но ACK и task claim не приходят. Репорт подробный, с патчами, но проблема не до конца решена. Это именно то место, ради которого ты ставишь OMX.
Апдейт перетирает локальные конфиги. Issue #1671 от 16 апреля: omx update консистентно переписывает пользовательский AGENTS.md и hook-entries без предупреждения. Пока не починят, держи .codex/config.toml и AGENTS.md в git и не обновляй OMX на проде.
Windows работает только через psmux, не нативно. Документация в мягкой форме предупреждает: "primarily designed and actively tuned for macOS/Linux with Codex CLI". На Windows живёшь на костылях, tmux-фичи работают через эмулятор.
Intel Mac жрёт CPU из-за Gatekeeper. Рекомендованный воркэраунд в доке: xattr -dr com.apple.quarantine $(which omx) и пониженный concurrency. До патча терпи или переходи на Apple Silicon.
Хуки выключены по умолчанию. Для production-safety надо руками ставить OMX_HOOK_PLUGINS=1. Без этого lifecycle-хуки (PreToolUse, PostToolUse) не цепляются, и ты теряешь половину причины ставить OMX.
Team mode требует чистый git. Перед $team лидер должен закоммитить или застешить всё. Иначе worktrees падают с невнятной ошибкой в integration-report.md.
Альтернативы
-
Superpowers (
obra/superpowers) — кроссплатформенный скилл-фреймворк через SKILL.md. Работает в Claude Code, Codex, Cursor, Gemini CLI. Не даёт tmux-параллельности и не ведёт.omx/state, но зато один фреймворк на всё. Если гоняешь разные CLI, ставь его, а не OMX. -
oh-my-claudecode (OMC) — родной брат OMX от той же экосистемы, но для Claude Code. На npm опубликован как
oh-my-claude-sisyphus(да, они намеренно развели имена). Если primary CLI у тебя Claude Code, бери OMC. Он умеет делегировать воркеров на Codex и Gemini. -
just-every/code — форк Codex CLI от OpenAI. Не обёртка, а именно форк, с валидацией, browser integration, мультиагентами и темами. Более инвазивный путь: ты больше не используешь vanilla Codex, ты живёшь на Every Code. Если тебе мало wrap-подхода, смотри сюда.
Вердикт
Ставь прямо сейчас, если у тебя Codex Pro или Business, macOS или Linux, нужен параллелизм из коробки и не пугает работа с 0.x-версией. $team и .omx/ state реально дают новый уровень работы с Codex CLI. Держи версию 0.12.x до выхода 0.14.1, следи за #1627 и #1671.
Не ставь, если сидишь на Windows (живёшь на psmux), Intel Mac (CPU от Gatekeeper) или используешь Claude Code как primary агент. В этих случаях бери OMC или Superpowers. Они проще и не требуют Codex CLI как хоста.
Подожди, если тебе не нужна параллельность, а только лучшие промпты. 33 агента и 36 скиллов это круто, но за ними скрываются немалые накладные расходы на latency: MCP-серверы, tmux, state-sync. На мелких задачах голый Codex быстрее.
Как попробовать
- Поставь Node 20+ и Codex CLI:
npm install -g @openai/codex - Поставь OMX:
npm install -g oh-my-codex - Настрой и проверь:
omx setup && omx doctor - Запусти сессию:
omx --madmax --high - Внутри Codex набери
$deep-interview "добавить JWT в auth". OMX начнёт задавать вопросы до того, как писать план. Потом$ralplanдля подтверждения плана, потом$team 3:executorесли задача большая, или$ralphесли хватит одного worker'а.
Документация, троблшутинг и Discord в репо. Начни с DEMO.md, там готовый скрипт smoke-теста на 5 минут.
