# oh-my-codex (OMX)
Codex'iniz yalnız değil.
[](https://www.npmjs.com/package/oh-my-codex)
[](https://opensource.org/licenses/MIT)
[](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)** | **[OpenClaw Entegrasyon Kılavuzu](../openclaw-integration.tr.md)** | **[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ı.
## v0.9.0'daki Yenilikler — Spark Initiative
Spark Initiative, OMX içindeki native keşif ve inceleme yolunu güçlendiren sürümdür.
- **`omx explore` için native harness** — salt okunur depo keşfini Rust tabanlı daha hızlı ve daha sıkı bir yol üzerinden çalıştırır.
- **`omx sparkshell`** — uzun çıktıları özetleyen ve açık tmux pane yakalama desteği veren operatör odaklı native inceleme yüzeyidir.
- **Çapraz platform native release varlıkları** — `omx-explore-harness`, `omx-sparkshell` ve `native-release-manifest.json` için hydration yolu artık release pipeline'ın parçasıdır.
- **Güçlendirilmiş CI/CD** — `build` job'ına açık Rust toolchain kurulumu ile birlikte `cargo fmt --check` ve `cargo clippy -- -D warnings` eklendi.
Ayrıntılar için [v0.9.0 release notları](../release-notes-0.9.0.md) ve [release body](../release-body-0.9.0.md) dosyalarına bakın.
## İlk Oturum
Codex içinde:
```text
$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:
```bash
omx team 4:executor "parallelize a multi-module refactor"
omx team status
omx team shutdown
```
## Ö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:
```text
User
-> Codex CLI
-> AGENTS.md (orkestrasyon beyni)
-> ~/.codex/prompts/*.md (ajan prompt 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)
```
## Ana Komutlar
```bash
omx # Codex'i başlat (tmux'ta HUD ile birlikte)
omx setup # Prompt/skill/config'i kapsama göre kur + proje .omx + kapsama özel AGENTS.md
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 # 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 # 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="/AGENTS.md"
```
Bu, `CODEX_HOME` içindeki `AGENTS.md` ile proje `AGENTS.md` dosyasını (varsa) birleştirir ve ardından çalışma zamanı kaplamasını ekler.
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
omx team status
omx team resume
omx team shutdown
```
Önemli kural: İptal etmiyorsanız, görevler hâlâ `in_progress` durumundayken kapatmayın.
### Team shutdown policy
Use `omx team shutdown ` after the team reaches a terminal state.
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:
```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/`, `~/.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).
- `config.toml` güncellemeleri (her iki kapsam için):
- `notify = ["node", "..."]`
- `model_reasoning_effort = "medium"`
- `developer_instructions = "..."`
- `[features] multi_agent = true, child_agents_md = true`
- MCP sunucu girişleri (`omx_state`, `omx_memory`, `omx_code_intel`, `omx_trace`, `omx_wiki`)
- `[tui] status_line`
- Kapsama özel `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 `~/.codex/skills/`'a, `project` için `./.codex/skills/`'a kurulur)
Örnekler:
- Ajanlar: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
- Skill'ler: `deep-interview`, `ralplan`, `team`, `ralph`, `plan`, `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