Meta açıklama: oh-my-codex (OMX), Codex CLI üzerine inşa edilmiş bir orkestrasyon katmanı — yapılandırılmış planlama iş akışı, tmux tabanlı paralel worker'lar, izole git worktree'leri ve oturum sıfırlamasında kaybolmayan kalıcı bellek. Codex'in yerini almıyor, eksik olanı ekliyor.
Codex CLI'ı tek dosyalık görevlerin ötesinde bir şey için kullandıysan limitine çarpmışsındır: yapılandırılmış planlama aşaması yok, oturumlar arasında kalıcı durum yok, paralel çalışan birden fazla agent'ı koordine etmenin yolu yok.
oh-my-codex (OMX) tam olarak bunları ekleyen katman — Codex'i yürütme motoru olarak değiştirmeden.
Güncel sürüm: v0.13.1 (7 Nisan 2026). Kaynak: github.com/Yeachan-Heo/oh-my-codex, MIT lisansı.
oh-my-codex Nedir? (30 Saniyelik Cevap)
OMX, OpenAI Codex CLI'ın üzerine oturan bir iş akışı ve orkestrasyon katmanı. Codex'i asıl akıl yürütme ve kod üretimini yaparken bırakıyor ve şunları ekliyor:
- Standartlaştırılmış dört adımlı iş akışı (
$$
deep-interview →
$$ralplan →$$ralph /$$team) - Her biri izole bir git worktree'de çalışan tmux tabanlı paralel worker'lar
- Context budamasından sağ kurtulan
.omx/dizininde kalıcı durum ve bellek .codex/hooks.jsonüzerinden bağlanan native Codex hook'ları (PreToolUse/PostToolUse)- Canlı seansları izlemek için heads-up display (
omx hud --watch) - 33 özelleşmiş agent prompt'u ve 36 iş akışı skill'i
Resmi dokümanlardan analoji: "Codex için oh-my-zsh gibi." Codex'i fork'lamıyor veya değiştirmiyor. Seansları daha iyi prompt'lar, durum yönetimi ve ekip koordinasyonuyla sarıyor.
Ham Codex CLI'a Kıyasla OMX'in Ekledikleri
| Ham Codex CLI | Codex CLI + OMX | |
|---|---|---|
| Planlama aşaması | Yok | $deep-interview → $ralplan kapısı |
| Paralel worker'lar | Yok | omx team N:executor tmux aracılığıyla |
| Worker başına git izolasyonu | Yok | .omx/team//worktrees/worker-N'de otomatik worktree'ler |
| Oturum durumu | Yok | Plan'ları, log'ları ve belleği tutan .omx/ dizini |
| Hook'lar | Varsayılan olarak bağlı değil | PreToolUse/PostToolUse ile native .codex/hooks.json |
| Context sıfırlamasında bellek | Kaybolur | Öncelik not defteri + proje belleği dosyası |
Paket adı notu: oh-my-codex repo vs npm adlandırması
GitHub repo'su, npm paketi ve CLI komutları tutarlı biçimde oh-my-codex adıyla anılıyor. Kurulum:
npm install -g oh-my-codex
omx setupOMX, npm'de oh-my-codex olarak listeleniyor. Bu, npm paketi oh-my-claude-sisyphus olarak yayımlanan ilgili proje oh-my-claudecode (OMC)'den farklı — baştan bilinmesi gereken bir adlandırma uyumsuzluğu.
Temel Yetenekler
$deep-interview → $ralplan → $ralph / $team: Ana İş Akışı
Dört skill, belirsiz bir prompt'tan çalışan koda giden OMX'in kanonik yolunu tanımlıyor.
$deep-interview — herhangi bir plan oluşturulmadan önce niyet sınıflandırması ve netleştirmesi. Niyet sınıflandırması baştan yapılıyor, yani sonraki plan gerçekte ne istediğini yansıtıyor.
$ralplan — açık takas incelemesiyle yapılandırılmış bir implementasyon planı üretiyor. Onay zorunlu; onaylanmadan yürütme başlamıyor.
$ralph — "kaya asla durmaz." Onaylanan planı doğrulanmış tamamlanmışa taşıyan, durmak yerine hatalardan kurtaran kalıcı bir tamamlama döngüsü.
$team — N worker ile koordineli paralel yürütme. Her worker otomatik olarak izole bir git worktree alır; lider değişiklikleri artımlı olarak entegre eder.
# Ana yol: interview → plan → yürüt (tek sahip)
$deep-interview "auth modülünü session'dan JWT'ye taşı"
# [soruları yanıtla, planı onayla]
$ralph "onaylanan auth planını tamamlanmışa taşı"
# 3 worker ile paralel
$team 3:executor "onaylanan auth planını paralel yürüt"tmux Tabanlı Paralel Worker'lar ve İzole Git Worktree'leri
v0.11.x'den itibaren her omx team worker'ı .omx/team/<seans>/worktrees/worker-N adresinde otomatik olarak kendi git worktree'sini alıyor. Flag gerekmez. Worker'lar izole bağımsız branch'lere yazıyor; lider sürekli olarak entegre ediyor, çakışmalar integration-report.md'de yüzeye çıkıyor.
omx team 3:executor "auth modülünü refactor et"
omx team status refactor-auth-module
# worker-1: status=in_progress
# worker-2: status=completed
# integration: merged=2 conflicts=0
omx team resume refactor-auth-module # kesintiden sonra devam et
omx team shutdown refactor-auth-module # temizleKarışık sağlayıcı ekipleri OMX_TEAM_WORKER_CLI_MAP aracılığıyla çalışıyor:
OMX_TEAM_WORKER_CLI_MAP=codex,claude,gemini \
omx team 3:executor "full-stack implementasyon"Her worker sağlayıcıdan bağımsız olarak kendi worktree'sini alıyor.
Kalıcı Bellek ve Oturum Durumu (.omx/ Dizini)
.omx/
├── logs/ — oturum başına yürütme log'ları
├── memory/ — proje seviyesi bellek (context budamasından sağ kurulur)
├── plans/ — onaylanan plan artifakt'ları
├── research/ — autoresearch çıktısı
├── sessions/ — oturum meta verisi
├── state/ — çalışma zamanı durumu
└── team/ — ekip worker durumu ve worktree'leriÖncelik not defteri ve project-memory.json context penceresi sıfırlamalarından sağ kurtuluyor. Codex'in context'i budandığında bellek katmanı kritik proje kararlarını ve görev durumunu koruyor; bir sonraki oturum kaldığı yerden devam ediyor.
PreToolUse ve PostToolUse için Native Hook'lar
v0.13.1, OMX hook'larını Codex'in çalışma zamanı sözleşmesi (.codex/hooks.json) üzerinden native olarak bağladı; önceki sürümlerde gereken harici shim'i kaldırdı. PreToolUse herhangi bir araç çağrısından önce; PostToolUse sonra tetikleniyor. Yıkıcı komutlar otomatik olarak uyarı üretiyor; hatalar yapılandırılmış rehberlik yüzeye çıkıyor.
omx doctor # hook kurulum şeklini doğrula
omx exec --skip-git-repo-check -C . "Tam olarak OMX-EXEC-OK ile yanıtla" # canlı smoke testOMX vs oh-my-claudecode (OMC): Fark Ne?
Aynı yazar (Yeachan Heo). Aynı kavramsal tasarım. Farklı yürütme motoru.
| oh-my-codex (OMX) | oh-my-claudecode (OMC) | |
|---|---|---|
| Yürütme motoru | OpenAI Codex CLI | Claude Code |
| CLI ön eki | omx | omc |
| npm paketi | oh-my-codex | oh-my-claude-sisyphus |
| GitHub repo'su | Yeachan-Heo/oh-my-codex | Yeachan-Heo/oh-my-claudecode |
| Plugin yüzeyi | AGENTS.md, .codex/hooks.json | Claude Code plugin marketplace |
OMX = Codex CLI Orkestrasyonu
Codex birincil yürütme motoru. Claude ve Gemini OMX_TEAM_WORKER_CLI_MAP aracılığıyla ekip worker'ı olarak görünebiliyor, ama Codex varsayılan ve en iyi desteklenen yol.
OMC = Claude Code Orkestrasyon Plugin'i
OMC bir Claude Code plugin'i olarak kuruluyor ve Claude Code seansları içinde çalışıyor. omc team aracılığıyla görevleri Codex veya Gemini worker'larına devredebiliyor, ama Claude Code host. OMC'nin README'si Codex kullanıcılarını açıkça OMX'e yönlendiriyor: "Codex kullanıcıları için: oh-my-codex'e bakın — OpenAI Codex CLI için aynı orkestrasyon deneyimi."
Öncelikli olarak Codex CLI kullanıcısıysan OMX kullan. Claude Code kullanıcısıysan OMC kullan.
Gerçek Dünya Kullanım Senaryoları
Çok Agent'lı Paralel Refactoring
15'ten fazla dosyayı kapsayan büyük bir refactoring, OMX'in ekip modunun ek yükünü hak ettiği yer:
$deep-interviewkapsamı netleştiriyor — hangi dosyalar, hangi pattern, kabul kriterleri neler$ralplanfarklı yürütme birimlerine atanmış dosya gruplarıyla planı üretiyoromx team 3:executor "onaylanan refactoring planını yürüt"her biri kendi worktree'sinde üç worker başlatıyor- Lider tamamlanan branch'leri artımlı entegre ediyor; çakışmalar
integration-report.md'de erkenden yüzeye çıkıyor
Erken biten worker'lar manuel koordinasyon olmadan kuyruktan ek görev alabilir.
Uzun Süren Görevler için Async Delegasyon (Zaman Aşımı Yok)
Tek bir interaktif oturumu aşan görevler için — büyük migration'lar, kapsamlı test suite'leri, araştırma döngüleri — $ralph kalıcılık katmanını sağlıyor. Ralph araç hatasında veya context sıfırlamasında durmuyor; durumu log'luyor, kurtarıyor ve devam ediyor. omx autoresearch bunu hedef karşılandığında kendiliğinden sonlanan iteratif araştırma döngülerine uzatıyor.
Görev ortasında terminali kapatıp omx team resume ile devam etmek .omx/'den oturum durumunu geri yüklüyor. Ham Codex bu durumu kaybeder.
Kurulum ve Başlangıç (Genel Bakış)
npm install -g oh-my-codex
omx setup # prompt'ları, skill'leri, AGENTS.md'yi ve hook'ları kurar
omx doctor # kurulum şeklini doğrula
omx exec --skip-git-repo-check -C . "Tam olarak OMX-EXEC-OK ile yanıtla" # smoke testomx setup 33 agent prompt'u ve 36 iş akışı skill'i kuruyor, AGENTS.md üretiyor, .codex/config.toml yapılandırıyor ve hook'ları .codex/hooks.json üzerinden bağlıyor. Çalışma zamanına güvenmeden önce omx doctor çalıştır — aksi halde sessiz başarısızlık üretecek eksik dosyaları ve ön koşulları yakalıyor.
OMX Ne Zaman Yanlış Araç?
OMX anlamlı kurulum ve planlama ek yükü ekliyor. Şu durumlarda yanlış araç:
- Görev hedefli tek dosya değişikliği veya hızlı bir düzeltme — planlama kapısı kazanım olmadan sürtünme ekliyor
- Keşif modundasın ve yapılandırılmış kapılar istemiyorsun
- Windows'tasın ve production grade güvenilirlik istiyorsun — OMX resmi olarak macOS ve Linux'u hedefliyor; Windows desteği var ama açıkça non-default olarak işaretlenmiş
- Öncelikli olarak Claude Code kullanıcısıysın — bunun yerine OMC kullan
OMX aynı zamanda bir CI yedeği değil. Ekip runtime'ı bir oturum içinde paralel yürütmeyi yönetiyor; pipeline'ının test matrisi ve deployment kapıları ayrı konular.
Sık Sorulan Sorular
OMX Codex'in yerini alıyor mu?
Hayır. Codex yürütme motoru olmaya devam ediyor. OMX seansları yapılandırılmış iş akışı skill'leri ve ekip koordinasyonuyla sarıyor, ama tüm akıl yürütme ve kod üretimi hâlâ Codex üzerinden çalışıyor. OMX'i kaldırmak seni normal bir Codex seansına döndürüyor.
OMX'i Claude worker'larıyla kullanabilir miyim?
Evet, OMX_TEAM_WORKER_CLI_MAP aracılığıyla. claude dahil edecek şekilde ayarla ve omx team, Codex worker'larının yanında Claude CLI worker'ları başlatacak. Her worker sağlayıcıdan bağımsız olarak kendi git worktree'sini alıyor. Claude Code CLI'nın ayrıca kurulu ve kimliği doğrulanmış olması gerekiyor.
Windows'ta çalışıyor mu?
Kısmen. OMX'in README'si açık bir uyarı taşıyor: macOS ve Linux önerilen yol. Windows desteği var — v0.13.1 PowerShell komut çözümleme düzeltmeleri ve tmux güvenilirlik iyileştirmeleri içeriyor — ama "varsayılan deneyim değil, bozulabilir veya tutarsız davranabilir" olarak listeleniyor. OMX'i Windows'ta production ready değil deneysel olarak değerlendir.
Superpowers'dan farkı ne?
Superpowers (v5.0.7), oturum başlangıcında zorunlu SKILL.md dosyaları enjekte ederek Claude Code, Codex, Cursor, Gemini CLI ve diğerleri genelinde çalışan cross-platform bir skill framework'ü. OMX ise tmux tabanlı parallelism, kalıcı .omx/ durumu ve $deep-interview → $ralplan → $ralph/$team iş akışıyla özellikle Codex CLI orkestrasyon katmanı. Her ikisi de ham agent seanslarına yapı zorluyor; Superpowers bunu bir skill sistemi aracılığıyla cross-platform yapıyor, OMX bunu tam ekip koordinasyon runtime'ıyla Codex'e native yapıyor.
Net konuşmak gerekirse: OMX, ham Codex'in seni bıraktığı yerde devreye giriyor — çok dosyalı, uzun soluklu görevler, paralel yürütme, oturum sıfırlamasında kaybolmayan durum. Tek dosyalık bir düzeltme için değil. Büyük bir refactoring veya uzun bir migration çalışıyorsan ve her şeyi elle koordine etmekten bıktıysan — dene.
İyi kodlamalar.
