Codexplain: Codex’i Claude Code Gibi Konuşturma Projesi

Codex’i kullanırken kodu iyi düzelttiğini, ama açıklamalarında bazen “peki bu tam olarak ne demek?” dedirttiğini sık sık gördüm.
Özellikle rahatsız olduğum üç nokta vardı.

1. Dosya adı/fonksiyon adı odaklı açıklamalar
   • Codex bazen “hangi özelliğin nasıl aktığı”nı anlatmak yerine README.md, rust/codexplain.rs, package.json gibi dosya birimleri üzerinden açıklama yapıyor. Proje yapısını zaten biliyorsanız sorun olmuyor, ama ilk kez gördüğünüz bir kod tabanında çoğu zaman yeniden sormak gerekiyor.
2. Terminalde okunması zor düz yazı
   • Claude Code’daki gibi TLDR, tablo, diyagram, risk paneli, sonraki adım gibi yapılandırılmış açıklamalar verse çok daha hızlı okunurdu; ama Codex açıklamaları çoğu zaman düz yazıya yakın kalıyor.
3. Sonuca geç geliyor ve gereksiz ayrıntı çok fazla
   • Kullanıcı önce “peki şu anda tam olarak neyi bilmem gerekiyor?” diye merak ediyor, ama Codex bazen tüm bağlamı tek seferde anlatıyor.

Bu yüzden Codexplain’i yaptım.

Codexplain, Codex’in yerini alan bir model değil; Codex yanıtlarını proje içinde, yerel olarak daha okunabilir hale getiren bir explanation UX layer.

Başlıca özellikler:

• Açıklamaları TLDR / özet / tablo / mimari diyagramı / risk paneli / sonraki adım biçiminde düzenleme
• JSON, code, diff, patch, log, test output gibi strict artifact’ları aynen koruma
• explanation depth, architecture depth, abstraction level ayarı
• terminal-friendly semantic highlight
• codexplain/ tabanlı project-local yapılandırma
• Takımın ya da bireyin istediği custom explanation style eklenebilmesi
• yerel aç/kapat ve uninstall desteği

Kurulum:

npm install -g codexplain
codexplain install-codex --local --force

Codex kullanırken “kod doğru ama açıklama çok yetersiz” diye düşünenler bir denesin; eksik kalan noktaları ya da istediğiniz açıklama stilini issue olarak paylaşın! Star her zaman memnuniyetle karşılanır ⭐️