oh-my-codex 0.7.5 → 0.8.0

package/README.ru.md

@@ -1,10 +1,59 @@
-# oh-my-codex (OMX) README на русском
+# oh-my-codex (OMX)
 
-> Полная оригинальная документация: [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>Ваш codex не одинок.</em>
+</p>
 
-OMX — это слой оркестрации мультиагентной работы для 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)
 
-## Быстрый старт
+> **[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)**
+
+Слой мультиагентной оркестрации для [OpenAI Codex CLI](https://github.com/openai/codex).
+
+## Языки
+
+- [English](./README.md)
+- [한국어 (Korean)](./README.ko.md)
+- [日本語 (Japanese)](./README.ja.md)
+- [简体中文 (Chinese)](./README.zh.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 превращает Codex из однопользовательского агента в координированную систему:
+- Role prompts (`/prompts:name`) для специализированных агентов
+- Workflow skills (`$name`) для повторяемых режимов выполнения
+- Командная оркестрация в tmux (`omx team`, `$team`)
+- Постоянное состояние и память через MCP-серверы
+
+## Почему OMX
+
+Codex CLI хорошо справляется с прямыми задачами. OMX добавляет структуру для более крупной работы:
+- Декомпозиция и поэтапное выполнение (`team-plan -> team-prd -> team-exec -> team-verify -> team-fix`)
+- Постоянное состояние жизненного цикла режимов (`.omx/state/`)
+- Поверхности памяти и блокнота для длительных сессий
+- Операционные элементы управления для запуска, проверки и отмены
+
+OMX — это дополнение, а не форк. Он использует нативные точки расширения Codex.
+
+## Требования
+
+- macOS или Linux (Windows через WSL2)
+- Node.js >= 20
+- Установленный Codex CLI (`npm install -g @openai/codex`)
+- Настроенная аутентификация Codex
+
+## Быстрый старт (3 минуты)
 
 ```bash
 npm install -g oh-my-codex
@@ -12,25 +61,254 @@ omx setup
 omx doctor
 ```
 
-## Ключевые возможности
+Рекомендуемый профиль запуска для доверенной среды:
 
-- Запуск специализированных агентов через role prompts (`/prompts:name`)
-- Автоматизация повторяемых процессов через skills (`$name`)
-- Командная оркестрация в tmux (`omx team`, `$team`)
-- Постоянное хранение состояния и памяти через MCP-серверы
+```bash
+omx --xhigh --madmax
+```
+
+## Новое в v0.5.0
+
+- **Настройка с учётом области** через `omx setup --scope user|project` для гибких режимов установки.
+- **Маршрутизация Spark worker** через `--spark` / `--madmax-spark` — рабочие команды могут использовать `gpt-5.3-codex-spark` без принудительной модели лидера.
+- **Консолидация каталога** — удалены устаревшие промпты (`deep-executor`, `scientist`) и 9 устаревших навыков для более компактной поверхности.
+- **Уровни подробности уведомлений** для детализированного управления выводом CCNotifier.
+
+## Первая сессия
+
+Внутри 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"
+```
+
+Из терминала:
+
+```bash
+omx team 4:executor "parallelize a multi-module refactor"
+omx team status <team-name>
+omx team shutdown <team-name>
+```
+
+## Базовая модель
+
+OMX устанавливает и связывает следующие слои:
+
+```text
+User
+  -> Codex CLI
+    -> AGENTS.md (мозг оркестрации)
+    -> ~/.codex/prompts/*.md (каталог промптов агентов)
+    -> ~/.agents/skills/*/SKILL.md (каталог навыков)
+    -> ~/.codex/config.toml (функции, уведомления, MCP)
+    -> .omx/ (состояние выполнения, память, планы, журналы)
+```
 
 ## Основные команды
 
 ```bash
-omx
-omx setup
-omx doctor
+omx                # Запустить Codex (+ HUD в tmux при наличии)
+omx setup          # Установить промпты/навыки/конфиг по области + проект AGENTS.md/.omx
+omx doctor         # Диагностика установки/среды выполнения
+omx doctor --team  # Диагностика Team/swarm
+omx team ...       # Запуск/статус/возобновление/завершение рабочих tmux
+omx status         # Показать активные режимы
+omx cancel         # Отменить активные режимы выполнения
+omx reasoning <mode> # low|medium|high|xhigh
+omx tmux-hook ...  # init|status|validate|test
+omx hooks ...      # init|status|validate|test (рабочий процесс расширений плагинов)
+omx hud ...        # --watch|--json|--preset
+omx help
+```
+
+## Расширение Hooks (Дополнительная поверхность)
+
+OMX теперь включает `omx hooks` для создания шаблонов плагинов и валидации.
+
+- `omx tmux-hook` по-прежнему поддерживается и не изменён.
+- `omx hooks` является дополнительным и не заменяет рабочие процессы tmux-hook.
+- Файлы плагинов располагаются в `.omx/hooks/*.mjs`.
+- Плагины по умолчанию отключены; включите с помощью `OMX_HOOK_PLUGINS=1`.
+
+Полный рабочий процесс расширений и модель событий описаны в `docs/hooks-extension.md`.
+
+## Флаги запуска
+
+```bash
+--yolo
+--high
+--xhigh
+--madmax
+--force
+--dry-run
+--verbose
+--scope <user|project>  # только для setup
+```
+
+`--madmax` соответствует Codex `--dangerously-bypass-approvals-and-sandbox`.
+Используйте только в доверенных/внешних sandbox-окружениях.
+
+### Политика workingDirectory MCP (опциональное усиление)
+
+По умолчанию инструменты MCP state/memory/trace принимают `workingDirectory`, предоставленный вызывающей стороной.
+Чтобы ограничить это, задайте список разрешённых корней:
+
+```bash
+export OMX_MCP_WORKDIR_ROOTS="/path/to/project:/path/to/another-root"
+```
+
+При установке значения `workingDirectory` за пределами этих корней будут отклонены.
+
+## Codex-First управление промптами
+
+По умолчанию OMX внедряет:
+
+```text
+-c model_instructions_file="<cwd>/AGENTS.md"
+```
+
+Это добавляет проектные инструкции `AGENTS.md` в команды запуска Codex.
+Расширяет поведение Codex, но не заменяет/обходит основные системные политики Codex.
+
+Управление:
+
+```bash
+OMX_BYPASS_DEFAULT_SYSTEM_PROMPT=0 omx     # отключить внедрение AGENTS.md
+OMX_MODEL_INSTRUCTIONS_FILE=/path/to/instructions.md omx
+```
+
+## Командный режим
+
+Используйте командный режим для масштабной работы, которая выигрывает от параллельных исполнителей.
+
+Жизненный цикл:
+
+```text
+start -> assign scoped lanes -> monitor -> verify terminal tasks -> shutdown
+```
+
+Операционные команды:
+
+```bash
 omx team <args>
-omx status
-omx cancel
+omx team status <team-name>
+omx team resume <team-name>
+omx team shutdown <team-name>
+```
+
+Важное правило: не завершайте работу, пока задачи находятся в состоянии `in_progress`, если только не прерываете выполнение.
+
+### Политика очистки Ralph
+
+Когда команда работает в режиме ralph (`omx team ralph ...`), очистка при завершении
+применяет специальную политику, отличающуюся от обычного пути:
+
+| Поведение | Обычная команда | Команда Ralph |
+|---|---|---|
+| Принудительное завершение при сбое | Выбрасывает `shutdown_gate_blocked` | Обходит шлюз, логирует событие `ralph_cleanup_policy` |
+| Автоматическое удаление веток | Удаляет ветки worktree при откате | Сохраняет ветки (`skipBranchDeletion`) |
+| Логирование завершения | Стандартное событие `shutdown_gate` | Дополнительное событие `ralph_cleanup_summary` с разбивкой задач |
+
+Политика Ralph автоматически определяется из состояния командного режима (`linked_ralph`) или
+может быть указана явно через `omx team shutdown <name> --ralph`.
+
+Выбор Worker CLI для рабочих команды:
+
+```bash
+OMX_TEAM_WORKER_CLI=auto    # по умолчанию; использует claude, если worker --model содержит "claude"
+OMX_TEAM_WORKER_CLI=codex   # принудительно Codex CLI
+OMX_TEAM_WORKER_CLI=claude  # принудительно Claude CLI
+OMX_TEAM_WORKER_CLI_MAP=codex,codex,claude,claude  # CLI для каждого рабочего (длина=1 или количество рабочих)
+OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # опционально: отключить адаптивный откат queue->resend
 ```
 
-## Подробнее
+Примечания:
+- Аргументы запуска рабочих по-прежнему передаются через `OMX_TEAM_WORKER_LAUNCH_ARGS`.
+- `OMX_TEAM_WORKER_CLI_MAP` переопределяет `OMX_TEAM_WORKER_CLI` для выбора на уровне рабочего.
+- Отправка триггеров по умолчанию использует адаптивные повторные попытки (queue/submit, затем безопасный откат clear-line+resend при необходимости).
+- В режиме Claude worker OMX запускает рабочих как обычный `claude` (без дополнительных аргументов) и игнорирует явные переопределения `--model` / `--config` / `--effort`, чтобы Claude использовал стандартный `settings.json`.
+
+## Что записывает `omx setup`
+
+- `.omx/setup-scope.json` (сохранённая область установки)
+- Установки в зависимости от области:
+  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`
+  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`
+- Поведение при запуске: если сохранённая область — `project`, `omx` автоматически использует `CODEX_HOME=./.codex` (если `CODEX_HOME` ещё не задан).
+- Существующий `AGENTS.md` сохраняется по умолчанию. В интерактивных TTY-запусках setup запрашивает подтверждение перед перезаписью; `--force` перезаписывает без запроса (проверки безопасности активных сессий остаются в силе).
+- Обновления `config.toml` (для обеих областей):
+  - `notify = ["node", "..."]`
+  - `model_reasoning_effort = "high"`
+  - `developer_instructions = "..."`
+  - `[features] multi_agent = true, child_agents_md = true`
+  - Записи MCP-серверов (`omx_state`, `omx_memory`, `omx_code_intel`, `omx_trace`)
+  - `[tui] status_line`
+- Проектный `AGENTS.md`
+- Директории `.omx/` и конфигурация HUD
+
+## Агенты и навыки
+
+- Промпты: `prompts/*.md` (устанавливаются в `~/.codex/prompts/` для `user`, `./.codex/prompts/` для `project`)
+- Навыки: `skills/*/SKILL.md` (устанавливаются в `~/.agents/skills/` для `user`, `./.agents/skills/` для `project`)
+
+Примеры:
+- Агенты: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
+- Навыки: `autopilot`, `plan`, `team`, `ralph`, `ultrawork`, `cancel`
+
+## Структура проекта
+
+```text
+oh-my-codex/
+  bin/omx.js
+  src/
+    cli/
+    team/
+    mcp/
+    hooks/
+    hud/
+    config/
+    modes/
+    notifications/
+    verification/
+  prompts/
+  skills/
+  templates/
+  scripts/
+```
+
+## Разработка
+
+```bash
+git clone https://github.com/Yeachan-Heo/oh-my-codex.git
+cd oh-my-codex
+npm install
+npm run build
+npm test
+```
+
+## Документация
+
+- **[Полная документация](https://yeachan-heo.github.io/oh-my-codex-website/docs.html)** — Полное руководство
+- **[Справочник CLI](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#cli-reference)** — Все команды `omx`, флаги и инструменты
+- **[Руководство по уведомлениям](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#notifications)** — Настройка Discord, Telegram, Slack и webhook
+- **[Рекомендуемые рабочие процессы](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#workflows)** — Проверенные в бою цепочки навыков для типичных задач
+- **[Примечания к выпускам](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#release-notes)** — Что нового в каждой версии
+
+## Примечания
+
+- Полный журнал изменений: `CHANGELOG.md`
+- Руководство по миграции (после v0.4.4 mainline): `docs/migration-mainline-post-v0.4.4.md`
+- Заметки о покрытии и паритете: `COVERAGE.md`
+- Рабочий процесс расширений hook: `docs/hooks-extension.md`
+- Детали установки и участия: `CONTRIBUTING.md`
+
+## Благодарности
+
+Вдохновлено проектом [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode), адаптировано для Codex CLI.
+
+## Лицензия
 
-- Основной документ: [README.md](./README.md)
-- Сайт: https://yeachan-heo.github.io/oh-my-codex-website/
+MIT

package/README.tr.md

@@ -0,0 +1,314 @@
+# 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>Codex'iniz yalnız değil.</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)**
+
+[OpenAI Codex CLI](https://github.com/openai/codex) için çok ajanlı orkestrasyon katmanı.
+
+## Diller
+
+- [English](./README.md)
+- [한국어 (Korean)](./README.ko.md)
+- [日本語 (Japanese)](./README.ja.md)
+- [简体中文 (Chinese)](./README.zh.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, Codex'i tek oturumlu bir ajandan koordineli bir sisteme dönüştürür:
+- Uzmanlaşmış ajanlar için role prompts (`/prompts:name`)
+- Tekrarlanabilir çalışma modları için workflow skills (`$name`)
+- tmux'ta takım orkestrasyonu (`omx team`, `$team`)
+- MCP sunucuları aracılığıyla kalıcı durum ve bellek
+
+## Neden OMX
+
+Codex CLI doğrudan görevler için güçlüdür. OMX daha büyük işler için yapı ekler:
+- Ayrıştırma ve aşamalı yürütme (`team-plan -> team-prd -> team-exec -> team-verify -> team-fix`)
+- Kalıcı mod yaşam döngüsü durumu (`.omx/state/`)
+- Uzun süreli oturumlar için bellek ve notepad yüzeyleri
+- Başlatma, doğrulama ve iptal için operasyonel kontroller
+
+OMX bir eklentidir, fork değil. Codex'in yerel uzantı noktalarını kullanır.
+
+## Gereksinimler
+
+- macOS veya Linux (Windows WSL2 ile)
+- Node.js >= 20
+- Codex CLI kurulu (`npm install -g @openai/codex`)
+- Codex kimlik doğrulaması yapılandırılmış
+
+## Hızlı Başlangıç (3 dakika)
+
+```bash
+npm install -g oh-my-codex
+omx setup
+omx doctor
+```
+
+Güvenilir ortam için önerilen başlatma profili:
+
+```bash
+omx --xhigh --madmax
+```
+
+## v0.5.0'daki Yenilikler
+
+- `omx setup --scope user|project` ile **kapsam duyarlı kurulum** — esnek kurulum modları.
+- `--spark` / `--madmax-spark` ile **Spark worker yönlendirmesi** — takım çalışanlarının lider modelini zorlamadan `gpt-5.3-codex-spark` kullanabilmesi.
+- **Katalog birleştirme** — kullanımdan kaldırılmış prompt'lar (`deep-executor`, `scientist`) ve 9 kullanımdan kaldırılmış skill kaldırıldı.
+- **Bildirim ayrıntı seviyeleri** — CCNotifier çıktısı için ince taneli kontrol.
+
+## İlk Oturum
+
+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"
+```
+
+Terminalden:
+
+```bash
+omx team 4:executor "parallelize a multi-module refactor"
+omx team status <team-name>
+omx team shutdown <team-name>
+```
+
+## Temel Model
+
+OMX şu katmanları kurar ve bağlar:
+
+```text
+User
+  -> Codex CLI
+    -> AGENTS.md (orkestrasyon beyni)
+    -> ~/.codex/prompts/*.md (ajan prompt kataloğu)
+    -> ~/.agents/skills/*/SKILL.md (skill kataloğu)
+    -> ~/.codex/config.toml (özellikler, bildirimler, MCP)
+    -> .omx/ (çalışma zamanı durumu, bellek, planlar, günlükler)
+```
+
+## Ana Komutlar
+
+```bash
+omx                # Codex'i başlat (tmux'ta HUD ile birlikte)
+omx setup          # Prompt/skill/config'i kapsama göre kur + proje AGENTS.md/.omx
+omx doctor         # Kurulum/çalışma zamanı tanılamaları
+omx doctor --team  # Team/swarm tanılamaları
+omx team ...       # tmux takım çalışanlarını başlat/durum/devam et/kapat
+omx status         # Aktif modları göster
+omx cancel         # Aktif çalışma modlarını iptal et
+omx reasoning <mode> # low|medium|high|xhigh
+omx tmux-hook ...  # init|status|validate|test
+omx hooks ...      # init|status|validate|test (eklenti uzantı iş akışı)
+omx hud ...        # --watch|--json|--preset
+omx help
+```
+
+## Hooks Uzantısı (Ek Yüzey)
+
+OMX artık eklenti iskelesi ve doğrulaması için `omx hooks` içerir.
+
+- `omx tmux-hook` desteklenmeye devam eder ve değişmemiştir.
+- `omx hooks` ek niteliktedir ve tmux-hook iş akışlarını değiştirmez.
+- Eklenti dosyaları `.omx/hooks/*.mjs` konumunda bulunur.
+- Eklentiler varsayılan olarak kapalıdır; `OMX_HOOK_PLUGINS=1` ile etkinleştirin.
+
+Tam uzantı iş akışı ve olay modeli için `docs/hooks-extension.md` dosyasına bakın.
+
+## Başlatma Bayrakları
+
+```bash
+--yolo
+--high
+--xhigh
+--madmax
+--force
+--dry-run
+--verbose
+--scope <user|project>  # yalnızca setup
+```
+
+`--madmax`, Codex `--dangerously-bypass-approvals-and-sandbox` ile eşlenir.
+Yalnızca güvenilir/harici sandbox ortamlarında kullanın.
+
+### MCP workingDirectory politikası (isteğe bağlı sertleştirme)
+
+Varsayılan olarak, MCP durum/bellek/trace araçları çağıranın sağladığı `workingDirectory` değerini kabul eder.
+Bunu kısıtlamak için bir izin listesi belirleyin:
+
+```bash
+export OMX_MCP_WORKDIR_ROOTS="/path/to/project:/path/to/another-root"
+```
+
+Ayarlandığında, bu kökler dışındaki `workingDirectory` değerleri reddedilir.
+
+## Codex-First Prompt Kontrolü
+
+Varsayılan olarak, OMX şunu enjekte eder:
+
+```text
+-c model_instructions_file="<cwd>/AGENTS.md"
+```
+
+Bu, proje `AGENTS.md` yönlendirmesini Codex başlatma talimatlarına katmanlar.
+Codex davranışını genişletir, ancak Codex çekirdek sistem politikalarını değiştirmez/atlamaz.
+
+Kontroller:
+
+```bash
+OMX_BYPASS_DEFAULT_SYSTEM_PROMPT=0 omx     # AGENTS.md enjeksiyonunu devre dışı bırak
+OMX_MODEL_INSTRUCTIONS_FILE=/path/to/instructions.md omx
+```
+
+## Takım Modu
+
+Paralel çalışanlardan fayda sağlayan geniş kapsamlı işler için takım modunu kullanın.
+
+Yaşam döngüsü:
+
+```text
+start -> assign scoped lanes -> monitor -> verify terminal tasks -> shutdown
+```
+
+Operasyonel komutlar:
+
+```bash
+omx team <args>
+omx team status <team-name>
+omx team resume <team-name>
+omx team shutdown <team-name>
+```
+
+Önemli kural: İptal etmiyorsanız, görevler hâlâ `in_progress` durumundayken kapatmayın.
+
+### Ralph Temizlik Politikası
+
+Bir takım ralph modunda çalıştığında (`omx team ralph ...`), kapatma temizliği
+normal yoldan farklı özel bir politika uygular:
+
+| Davranış | Normal takım | Ralph takımı |
+|---|---|---|
+| Başarısızlıkta zorla kapatma | `shutdown_gate_blocked` hatası verir | Kapıyı atlar, `ralph_cleanup_policy` olayını günlükler |
+| Otomatik dal silme | Geri almada worktree dallarını siler | Dalları korur (`skipBranchDeletion`) |
+| Tamamlanma günlükleme | Standart `shutdown_gate` olayı | Görev dökümü ile ek `ralph_cleanup_summary` olayı |
+
+Ralph politikası takım modu durumundan (`linked_ralph`) otomatik algılanır veya
+`omx team shutdown <name> --ralph` ile açıkça belirtilebilir.
+
+Takım çalışanları için Worker CLI seçimi:
+
+```bash
+OMX_TEAM_WORKER_CLI=auto    # varsayılan; worker --model "claude" içeriyorsa claude kullanır
+OMX_TEAM_WORKER_CLI=codex   # Codex CLI çalışanlarını zorla
+OMX_TEAM_WORKER_CLI=claude  # Claude CLI çalışanlarını zorla
+OMX_TEAM_WORKER_CLI_MAP=codex,codex,claude,claude  # çalışan başına CLI karışımı (uzunluk=1 veya çalışan sayısı)
+OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # isteğe bağlı: adaptif queue->resend geri dönüşünü devre dışı bırak
+```
+
+Notlar:
+- Worker başlatma argümanları hâlâ `OMX_TEAM_WORKER_LAUNCH_ARGS` aracılığıyla paylaşılır.
+- `OMX_TEAM_WORKER_CLI_MAP`, çalışan başına seçim için `OMX_TEAM_WORKER_CLI`'yi geçersiz kılar.
+- Tetikleyici gönderimi varsayılan olarak adaptif yeniden denemeler kullanır (queue/submit, ardından gerektiğinde güvenli clear-line+resend geri dönüşü).
+- Claude worker modunda, OMX çalışanları düz `claude` olarak başlatır (ekstra başlatma argümanı yok) ve açık `--model` / `--config` / `--effort` geçersiz kılmalarını yok sayar, böylece Claude varsayılan `settings.json` kullanır.
+
+## `omx setup` Ne Yazar
+
+- `.omx/setup-scope.json` (kalıcı kurulum kapsamı)
+- Kapsama bağlı kurulumlar:
+  - `user`: `~/.codex/prompts/`, `~/.agents/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`
+  - `project`: `./.codex/prompts/`, `./.agents/skills/`, `./.codex/config.toml`, `./.omx/agents/`
+- Başlatma davranışı: kalıcı kapsam `project` ise, `omx` başlatma otomatik olarak `CODEX_HOME=./.codex` kullanır (`CODEX_HOME` zaten ayarlanmadıysa).
+- Mevcut `AGENTS.md` varsayılan olarak korunur. Etkileşimli TTY çalıştırmalarında, üzerine yazmadan önce setup sorar; `--force` sormadan üzerine yazar (aktif oturum güvenlik kontrolleri hâlâ geçerlidir).
+- `config.toml` güncellemeleri (her iki kapsam için):
+  - `notify = ["node", "..."]`
+  - `model_reasoning_effort = "high"`
+  - `developer_instructions = "..."`
+  - `[features] multi_agent = true, child_agents_md = true`
+  - MCP sunucu girişleri (`omx_state`, `omx_memory`, `omx_code_intel`, `omx_trace`)
+  - `[tui] status_line`
+- Proje `AGENTS.md`
+- `.omx/` çalışma zamanı dizinleri ve HUD yapılandırması
+
+## 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)
+
+Örnekler:
+- Ajanlar: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
+- Skill'ler: `autopilot`, `plan`, `team`, `ralph`, `ultrawork`, `cancel`
+
+## Proje Yapısı
+
+```text
+oh-my-codex/
+  bin/omx.js
+  src/
+    cli/
+    team/
+    mcp/
+    hooks/
+    hud/
+    config/
+    modes/
+    notifications/
+    verification/
+  prompts/
+  skills/
+  templates/
+  scripts/
+```
+
+## Geliştirme
+
+```bash
+git clone https://github.com/Yeachan-Heo/oh-my-codex.git
+cd oh-my-codex
+npm install
+npm run build
+npm test
+```
+
+## Dokümantasyon
+
+- **[Tam Dokümantasyon](https://yeachan-heo.github.io/oh-my-codex-website/docs.html)** — Eksiksiz kılavuz
+- **[CLI Referansı](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#cli-reference)** — Tüm `omx` komutları, bayraklar ve araçlar
+- **[Bildirim Kılavuzu](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#notifications)** — Discord, Telegram, Slack ve webhook kurulumu
+- **[Önerilen İş Akışları](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#workflows)** — Yaygın görevler için savaşta test edilmiş skill zincirleri
+- **[Sürüm Notları](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#release-notes)** — Her sürümdeki yenilikler
+
+## Notlar
+
+- Tam değişiklik günlüğü: `CHANGELOG.md`
+- Geçiş rehberi (v0.4.4 sonrası mainline): `docs/migration-mainline-post-v0.4.4.md`
+- Kapsam ve eşitlik notları: `COVERAGE.md`
+- Hook uzantı iş akışı: `docs/hooks-extension.md`
+- Kurulum ve katkı detayları: `CONTRIBUTING.md`
+
+## Teşekkürler
+
+[oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode)'dan ilham alınmıştır, Codex CLI için uyarlanmıştır.
+
+## Lisans
+
+MIT