diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..0ba6da8
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,11 @@
+blank_issues_enabled: true
+contact_links:
+ - name: ⬇️ Codex'i indir
+ url: https://codex.numexai.com.tr
+ about: IDE, VS Code eklentisi ve CLI.
+ - name: 🧰 Numex SDK (açık kaynak)
+ url: https://github.com/mobilcep/numex-sdk
+ about: Codex'i kendi kodundan çalıştır.
+ - name: 🔒 Güvenlik bildirimi
+ url: mailto:destek@numexai.com.tr
+ about: Güvenlik açıklarını e-postayla bildir.
diff --git a/.github/ISSUE_TEMPLATE/hata-bildir.yml b/.github/ISSUE_TEMPLATE/hata-bildir.yml
new file mode 100644
index 0000000..5bd34bb
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/hata-bildir.yml
@@ -0,0 +1,44 @@
+name: 🐞 Hata bildir
+description: Numex Codex'te (IDE, VS Code, CLI, Web) bir hata bildir
+labels: ["hata"]
+body:
+ - type: dropdown
+ id: kapi
+ attributes:
+ label: Hangi Codex?
+ options: [Codex IDE (masaüstü), VS Code eklentisi, Codex CLI, Codex Web, Uzaktan PC köprüsü]
+ validations:
+ required: true
+ - type: input
+ id: surum
+ attributes:
+ label: Sürüm ve işletim sistemi
+ placeholder: "ör. IDE v2.9.59 · Windows 11 / CLI v3.3.10 · Node 22 · Ubuntu"
+ validations:
+ required: true
+ - type: dropdown
+ id: mod
+ attributes:
+ label: Hangi mod?
+ options: [Sohbet, Plan, Otonom, Hata Avcısı, Konsey, Misyon, Bilmiyorum]
+ - type: textarea
+ id: ne-oldu
+ attributes:
+ label: Ne oldu?
+ validations:
+ required: true
+ - type: textarea
+ id: adimlar
+ attributes:
+ label: Nasıl tekrarlanır?
+ placeholder: |
+ 1. numex "..." yazdım
+ 2. ...
+ - type: textarea
+ id: log
+ attributes:
+ label: Log / konsey raporu / ekran görüntüsü
+ description: "`.numex/logs` veya `.numex/audit/audit-trail.jsonl`'den ilgili satırlar işe yarar. Token, e-posta, API anahtarı gibi bilgileri gizle."
+ - type: markdown
+ attributes:
+ value: "🔒 Güvenlik açığı mı? Lütfen issue açma: destek@numexai.com.tr"
diff --git a/.github/ISSUE_TEMPLATE/ozellik-istegi.yml b/.github/ISSUE_TEMPLATE/ozellik-istegi.yml
new file mode 100644
index 0000000..6cb592d
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/ozellik-istegi.yml
@@ -0,0 +1,16 @@
+name: 💡 Özellik isteği
+description: Codex için bir fikir öner
+labels: ["öneri"]
+body:
+ - type: textarea
+ id: sorun
+ attributes:
+ label: Hangi sorunu çözüyor?
+ validations:
+ required: true
+ - type: textarea
+ id: oneri
+ attributes:
+ label: Önerin
+ validations:
+ required: true
diff --git a/README.en.md b/README.en.md
new file mode 100644
index 0000000..90238d0
--- /dev/null
+++ b/README.en.md
@@ -0,0 +1,88 @@
+
+
+
+
+# Numex Codex
+
+### A coding agent that thinks in Turkish — for your editor, terminal and browser.
+
+**Ask. It writes, runs and verifies — until the job is actually done.**
+
+[🇹🇷 Türkçe](README.md) · 🇬🇧 **English**
+
+
+
+
+
+# Numex Codex
+
+### Editörüne Türkçe düşünen bir kod ajanı.
+
+**İste, yazsın, çalıştırsın — iş bitene kadar.**
+
+[](https://codex.numexai.com.tr)
+[](https://codex.numexai.com.tr)
+[](https://codex.numexai.com.tr)
+[](https://github.com/mobilcep/numex-sdk)
+
+🇹🇷 Türkçe · [🇬🇧 English](README.en.md)
+
+
+
+---
+
+**Numex Codex** · [Numex Ailesi](https://www.numexai.com.tr/aile)'nin geliştirici kapısı
+*İnsanı önce koyan Türk yapay zekâsı* 🇹🇷
+
+
diff --git a/docs/komutlar.md b/docs/komutlar.md
new file mode 100644
index 0000000..8ea6c31
--- /dev/null
+++ b/docs/komutlar.md
@@ -0,0 +1,83 @@
+# ⌨️ Komutlar ve Kısayollar
+
+## Codex CLI
+
+| Komut | Açıklama |
+|---|---|
+| `numex` | Etkileşimli terminal sohbeti (REPL) |
+| `numex basla` | Giriş + başlangıç menüsü (terminal sohbeti / web'den PC kontrolü) |
+| `numex login` | Tarayıcı onaylı cihaz girişi |
+| `numex ""` | Tek seferlik görev |
+| `numex plan ""` | Mimar planlayıcı — kod değiştirmez |
+| `numex mission ""` | İzole sandbox çalışma alanlarında uzun süreli otonom misyon |
+| `numex undo` | Son turu geri al |
+| `numex --devam` | Son oturumdan devam et |
+| `numex --offline ""` | Yerel Ollama ile internetsiz çalış |
+| `numex --api-key nx_live_…` | API anahtarı tanımla |
+| `numex --version` | Sürüm |
+| `numex uzak` | Uzaktan PC köprüsünü başlat (terminal açık kalır) |
+| `numex uzak install` | Köprüyü arka plan servisi olarak kur (sistem tepsisi) |
+| `numex uzak pause` | Köprüyü duraklat |
+
+### REPL içi komutlar
+
+| Komut | Açıklama |
+|---|---|
+| `/yardim` | Yardım |
+| `/cikis` | Çıkış |
+| `/model fast \| pro \| code` | Aktif profili kilitle |
+| `/proje "C:\yol\proje"` | Belirli bir projeye geç (proje hafızası yüklenir) |
+
+### Konseyi çağırma ifadeleri
+*"konseyi topla"* · *"ajanları çağır"* · *"ekibi topla"* · *"takımı çağır"* · *"herkesi topla"* ·
+*"hep birlikte bak"* · *"swarm council"*
+
+## Codex IDE / VS Code eklentisi
+
+### Kısayollar
+
+| Kısayol | İşlev |
+|---|---|
+| `Ctrl+Alt+M` | Sohbeti aç/kapat |
+| `Ctrl+Alt+N` | Seçimi sor |
+| `Ctrl+K` | Satır içi düzenle |
+| `Tab` | Sonraki düzenleme önerisini uygula |
+
+### Komut paleti (`Ctrl+Shift+P` → "Numex")
+
+| Grup | Komutlar |
+|---|---|
+| **Başlangıç** | Hoş Geldiniz · Bu klasörde çalış · Çalışma klasörü seç / sıfırla · Giriş / Çıkış |
+| **Sohbet** | Sohbeti Aç/Kapat · Sohbet Paneli · Yeni Sohbet · Sohbet Geçmişi · Transkripti Dışa Aktar · Son Yanıtı Tekrar Üret |
+| **Kod** | Seçimi Sor · Bu Dosya Hakkında Sor · Seçimi Açıkla · Kod Lens Sorgusu · Satır-içi Düzenle · Sonraki Düzenlemeyi Uygula / Kapat · Dosyadaki Hataları AI ile Düzelt · Composer |
+| **Kod tabanı** | Projeyi İndeksle · Yeniden İndeksle (leksikal) · Anlamsal Aramayı Aç · Kod Tabanında Ara |
+| **Görsel** | Ekran Görüntüsü Al ve Sohbete Ekle · Tarayıcıyı Aç · Design Mode |
+| **Terminal** | Terminal Komutu Üret (doğal dil) · Terminal Çıktısını Sohbete Gönder |
+| **Git** | Commit Mesajı Üret · Değişiklikleri İncele (AI) · Pull Request Aç |
+| **Ajanlar** | Otonom Modu Aç/Kapat · Arka Plan Ajanı · Bulut Ajanı |
+| **Uzak** | Uzak Sunucuya Bağlan · SSH ile Bağlan · WSL ile Bağlan |
+| **Diğer** | Ayarlar · Ekran Dilini Seç · Güncellemeleri Denetle · Destek / Hata Bildir |
+
+### Eklenti ayarları
+
+| Ayar | Varsayılan | Açıklama |
+|---|---|---|
+| `numex.command` | `numex` | CLI komutu veya tam yolu |
+| `numex.extraArgs` | — | REPL başlatma argümanları (ör. `--yolo --lint`) |
+
+## Codex Web
+
+| Kısayol | İşlev |
+|---|---|
+| `Ctrl+N` / `Ctrl+Shift+N` | Yeni proje / yeni dosya |
+| `Ctrl+O` | Proje aç |
+| `Ctrl+S` / `Ctrl+Shift+S` | Kaydet / tümünü kaydet |
+| `Ctrl+Shift+P` | Yayınla |
+| `Ctrl+K` | Komut paleti |
+| `Ctrl+B` | Dosya gezgini |
+| `Ctrl+F` / `Ctrl+H` | Bul / değiştir |
+| `F11` | Tam ekran |
+| `Ctrl+Shift+K` | Klavye kısayolları |
+
+---
+← [Ana sayfa](../README.md)
diff --git a/docs/konsey.md b/docs/konsey.md
new file mode 100644
index 0000000..79c69b0
--- /dev/null
+++ b/docs/konsey.md
@@ -0,0 +1,156 @@
+# 🏛️ Numex Konseyi — 4 Uzman, Tek Görev
+
+> *"Kullanıcı tek bir istek atar; arka planda 4 uzman ajan toplanır, tartışır ve kanıtlanmış bir sonuç üretir."*
+
+Çoğu kod ajanı tek bir modelin her şeyi aynı anda yapmasına dayanır: planlar, yazar, test eder ve
+"bitti" der. Bu, **kendi ödevini kendi notlandıran bir öğrenciye** benzer. Numex Codex'te karmaşık
+işler bunun yerine bir **Konsey**'e (Swarm Council) verilir. Her üyenin tek bir işi ve **sınırlı bir
+yetkisi** vardır.
+
+---
+
+## 👥 Konsey üyeleri
+
+| Üye | Görevi | Yetkisi | Yazabilir mi? |
+|---|---|---|---|
+| 📐 **Mimar** | Klasör yapısını, veri modelini ve dosya listesini çizer; her dosya için fonksiyonları ve parametreleri tek tek planlar | Sadece okuma + plan | ❌ Sadece öneri |
+| 💻 **Kodlayıcı** | Mimar'ın planına göre **tam ve çalışan** kodu yazar | Okuma + yazma | ✅ **Tek yazıcı** |
+| 🛡️ **Denetçi** | Yazılanı okur, test eder, açıkları bulur, doğrular | Okuma + komut | ❌ Sadece test/rapor |
+| 🎨 **Tasarımcı** | Arayüzü ve kullanıcı deneyimini cilalar | Okuma + yazma (yalnızca CSS/HTML) | ⚠️ Sadece arayüz dosyaları |
+
+### Altın kural: aynı anda tek yazıcı
+Kodu **yalnızca Kodlayıcı** yazar. Diğerleri okur ve eleştirir; Tasarımcı sadece CSS/HTML'e dokunur,
+JavaScript mantığına karışmaz. Böylece iki ajanın aynı dosyayı aynı anda değiştirmesi (race
+condition) baştan imkânsızdır.
+
+### Her üyenin "yapmayacağı" da tanımlı
+- **Mimar kod yazmaz, doğrulama yapmaz.** Plan yapar ve bitirir. Plan belirsizse bu başarısızlık
+ sayılır: *"Vague plan = BAŞARISIZ."*
+- **Kodlayıcı boşluğu uydurmaz.** Görev belirsizse kafasından bir proje icat etmek yerine
+ *"GÖREV BELİRSİZ: [ne eksik]"* diye durur. Asla iskelet, `TODO` ya da yer tutucu kod bırakmaz.
+- **Denetçi dosyalara yazamaz.** Okur ve rapor verir — tarafsız kalması için.
+- **Tasarımcı sunucuyu başlatıp durdurmaz**, iş mantığını değiştirmez.
+
+---
+
+## 🔄 Konsey nasıl çalışır?
+
+```mermaid
+flowchart TD
+ U([👤 Senin isteğin]) --> B{🎚️ Karmaşıklık
ve bütçe değerlendirmesi}
+ B -->|basit| S[Tek ajan
hızlı düzeltme]
+ B -->|orta / karmaşık| A[📐 Mimar
plan + dosya yapısı]
+ A --> K{Plan görevle
örtüşüyor mu?}
+ K -->|hayır| C2[Kodlayıcı planı yok sayar,
orijinal isteği esas alır]
+ K -->|evet| C[💻 Kodlayıcı
kodu yazar]
+ C2 --> H
+ C --> H[🔁 Self-Healing
kendi hatalarını düzeltir]
+ H --> D[🛡️ Denetçi
görev uyumu + test]
+ H --> T[🎨 Tasarımcı
arayüz cilası]
+ D -->|sorun var| C
+ D -->|temiz| G{🚦 FinishGate
canlı kanıt var mı?}
+ T --> G
+ G -->|HTTP 200 · test · DOM ✓| OK([✅ Onaylandı])
+ G -->|kanıt yok| H
+```
+
+1. **Değerlendirme.** İstek bir karmaşıklık seviyesine yerleştirilir; kaç üyenin çağrılacağına ve
+ token bütçesine göre karar verilir (aşağıdaki tablo).
+2. **Plan.** Mimar ayrıntılı bir plan çıkarır.
+3. **Konu sapması kontrolü.** Mimar'ın planı gerçekten istenen şey mi? Tek satırlık hızlı bir yapay
+ zekâ yargısıyla kontrol edilir. Plan konudan saparsa Kodlayıcı planı görmezden gelir ve **senin
+ orijinal isteğini** esas alır.
+4. **Yazım + Self-Healing.** Kodlayıcı yazar; sözdizimi, yapı, veri bütünlüğü, parantez dengesi
+ kontrol edilir ve Kodlayıcı kendi hatalarını düzeltir.
+5. **Denetim ve cila (paralel).** Denetçi test ederken Tasarımcı arayüzü cilalar.
+6. **Geri bildirim döngüsü.** Denetçi sorun bulursa iş Kodlayıcı'ya döner. Sonsuz döngüye girmemek
+ için tur sayısı sınırlıdır; sınır aşılırsa sana sorulur.
+7. **FinishGate.** Görev ancak **canlı kanıtla** kapanır: sunucu HTTP 200 dönüyor, testler geçiyor,
+ tarayıcıda DOM beklenen öğeleri içeriyor.
+
+---
+
+## 🎚️ Her iş için doğru ekip
+
+*"Bir el arabası toprak için kepçe + kamyon + formen çağrılmaz."* Konsey, token maliyeti 4 kata
+çıkabileceği için sadece gerektiğinde toplanır:
+
+| Seviye | Örnek | Çağrılan üyeler | Düzeltme turu | Tahmini token |
+|---|---|---|---|---|
+| **Basit (trivial)** | *"başlığı değiştir"* | — (tek ajan) | 0 | ~500 |
+| **Kolay** | *"tek dosyada şu fonksiyonu düzelt"* | Kodlayıcı + Denetçi | 1 | ~3.000 |
+| **Orta** | Birkaç modüllük özellik | Mimar + Kodlayıcı + Denetçi | 2 | ~7.500 |
+| **Karmaşık** | *"frontend + backend + veritabanlı sistem"* | Tam konsey (4 üye) | 2 | ~15.000 |
+| **Kurumsal** | *"komple, tüm modüller, mikroservis"* | 4 üye + ek denetim turu | 3 | ~30.000 |
+
+Bütçe yetmiyorsa konsey başlamadan önce söylenir: *"Yetersiz token bütçesi (Kalan: …, Gerekli: …)"*.
+
+### Konsey ne zaman toplanmaz?
+- **Hedefli düzeltmede:** *"modal kapanmıyor"*, *"şu butonu düzelt"* → 15 dakikalık senfoni değil,
+ neşter.
+- **Tek dosyalık işte:** *"tek bir index.html yap"* → tek ajan parça parça yazar.
+- **Sadece uzun anlattığında:** Uzun ve samimi bir anlatım (ör. *"kızım için bir org uygulaması…"*)
+ tek başına "karmaşık" sayılmaz; gerçek bir teknik karmaşıklık işareti gerekir (mimari, sistem,
+ backend, veritabanı…).
+
+### Konseyi kendin çağırmak
+İstediğin an konseyi çağırabilirsin — bu, otomatik karmaşıklık kararını atlar:
+
+> *"konseyi topla"* · *"ajanları çağır"* · *"ekibi topla"* · *"takımı çağır"* · *"herkesi topla"* ·
+> *"hep birlikte bak"* · *"swarm council"*
+
+Tersine, ayarlardan konsey modunu tamamen kapatabilirsin.
+
+---
+
+## 🛡️ Denetçi'nin ilk sorusu: "Doğru şeyi mi yaptık?"
+
+Temiz kod her zaman doğru kod değildir. Numex'in canlı testlerinde bir *"Proje Sağlık Kontrolü CLI"*
+isteğinin tamamen alakasız ama kusursuz yazılmış bir *"Hafıza Kartları"* oyununa dönüştüğü
+görülmüştü — ve kod iç tutarlılık açısından mükemmel olduğu için fark edilmemişti.
+
+Bu yüzden Denetçi'nin **ilk** işi, tek bir dosya bile okumadan önce **görev uyum kontrolü**dür:
+
+> *"Kod ne kadar temiz olursa olsun, YANLIŞ ŞEYİN temiz kodu bir BAŞARISIZLIKTIR."*
+
+---
+
+## 📜 Konsey raporu
+
+Her konsey çalışmasının sonunda ne olduğunu düz Türkçe ile anlatan bir özet görürsün:
+
+```
+🏛️ Konsey birlikte çalıştı:
+Mimar önce bir plan hazırladı, Kodlayıcı bu planı takip etti.
+Kodlayıcı uygulamayı yazdı ve 1 self-healing turunda kendi çıkardığı hataları kendi düzeltti.
+Denetçi işi inceledi, sorun buldu; Kodlayıcı bunları 1 turda düzeltti, Denetçi tekrar kontrol edip onayladı.
+Tasarımcı son olarak arayüzü gözden geçirip cilaladı.
+✅ Sonuç: tüm kontroller geçti, onaylandı.
+```
+
+Bir şey çözülemediyse bunu da açıkça söyler: *"🚫 Sonuç: 2 sorun hâlâ çözülmeden kaldı, gözden
+geçirilmeli."* Numex başarısızlığı başarı gibi göstermez.
+
+---
+
+## 🏗️ Scaffold Konseyi
+
+Sıfırdan yeni bir ürün iskeleti kurulurken aynı dört rolün **iskelet versiyonları** çalışır:
+**Scaffold Mimarı**, **Scaffold Kodcusu**, **Scaffold Denetçisi** ve **Scaffold Tasarımcısı**.
+Sonuçları tek bir alan şemasında (veri modeli + API + arayüz) birleştirilir.
+
+---
+
+## 🎯 Neden önemli?
+
+| Tek ajan | Numex Konseyi |
+|---|---|
+| Kendi planını kendi onaylar | Plan, konu sapmasına karşı ayrıca kontrol edilir |
+| Kendi kodunu kendi test eder | Yazamayan, tarafsız bir Denetçi test eder |
+| "Bitti!" der | FinishGate canlı kanıt ister |
+| Her iş için aynı maliyet | İşin büyüklüğüne göre ekip ve bütçe |
+| Ne yaptığı belirsiz | Düz Türkçe konsey raporu + `.numex/audit` kaydı |
+
+---
+
+← [Ana sayfa](../README.md) · [Komutlar](komutlar.md) · [.numex klasörü](numex-klasoru.md)
diff --git a/docs/numex-klasoru.md b/docs/numex-klasoru.md
new file mode 100644
index 0000000..1b20cc9
--- /dev/null
+++ b/docs/numex-klasoru.md
@@ -0,0 +1,31 @@
+# 🧠 `.numex/` — Ajanın Şeffaf Hafızası
+
+Codex, her projede **açık ve okunabilir** bir `.numex/` klasörü tutar. Ajanın ne bildiği ve ne
+yaptığı bir kara kutuda değil, **senin diskinde, düz dosyalarda** durur.
+
+| Dosya / klasör | İçerik |
+|---|---|
+| `rag/index.json` · `rag/graph.json` · `rag/symbols.json` · `rag/summary.md` | Kod tabanı indeksi, bağımlılık grafiği, sembol tablosu, proje özeti |
+| `audit/audit-trail.jsonl` | Ajanın yaptığı **her işlemin** zaman damgalı denetim kaydı |
+| `checkpoints/stack.json` · `checkpoints/redo.json` | Geri al / yinele noktaları (`numex undo`) |
+| `mission-state.json` · `async-tasks.json` | Süren otonom misyonlar ve arka plan görevleri |
+| `agent-registry.json` · `services.json` | Kayıtlı ajanlar ve çalışan servisler (ör. geliştirme sunucusu) |
+| `learned-errors.json` · `rag/error-kb-local.json` | Bu projede öğrenilen hatalar ve çözümleri |
+| `chronicle.jsonl` · `digest.md` | Oturum günlüğü ve özet |
+| `project-map-cache.json` | Proje haritası önbelleği |
+| `telemetry/token-usage.jsonl` · `sessions/*-usage.json` | Token kullanımı |
+| `economy-state.json` | Bütçe / maliyet durumu |
+| `logs/` | Ajan logları |
+
+## Neden önemli?
+
+- **Denetlenebilirlik:** "Dün bu projeye ne oldu?" → `audit-trail.jsonl`.
+- **Süreklilik:** Projeyi kapatıp açtığında ajan projeyi yeniden öğrenmez, kaldığı yerden devam eder.
+- **Öğrenme:** Aynı hatayı ikinci kez yaşamamak için çözümler projeye özel saklanır.
+- **Sahiplik:** Hafıza senin projende; istersen okursun, istersen silersin.
+
+> İpucu: `.numex/` klasörünü `.gitignore`'a ekleyebilir ya da ekip arkadaşlarınla indeksi paylaşmak
+> için bazı dosyalarını depoda tutabilirsin.
+
+---
+← [Ana sayfa](../README.md)
diff --git a/gorseller/agent-diff.png b/gorseller/agent-diff.png
new file mode 100644
index 0000000..cf99cd9
Binary files /dev/null and b/gorseller/agent-diff.png differ
diff --git a/gorseller/agent-modu.png b/gorseller/agent-modu.png
new file mode 100644
index 0000000..34e99d0
Binary files /dev/null and b/gorseller/agent-modu.png differ
diff --git a/gorseller/cli-codex-acilis.png b/gorseller/cli-codex-acilis.png
new file mode 100644
index 0000000..e78eb53
Binary files /dev/null and b/gorseller/cli-codex-acilis.png differ
diff --git a/gorseller/cli-menu.png b/gorseller/cli-menu.png
new file mode 100644
index 0000000..3b0790f
Binary files /dev/null and b/gorseller/cli-menu.png differ
diff --git a/gorseller/codex-banner.png b/gorseller/codex-banner.png
new file mode 100644
index 0000000..2f1e19b
Binary files /dev/null and b/gorseller/codex-banner.png differ
diff --git a/gorseller/codex-ide-ayarlar-swarm.png b/gorseller/codex-ide-ayarlar-swarm.png
new file mode 100644
index 0000000..fbf59f1
Binary files /dev/null and b/gorseller/codex-ide-ayarlar-swarm.png differ
diff --git a/gorseller/codex-rehber.png b/gorseller/codex-rehber.png
new file mode 100644
index 0000000..bcf3916
Binary files /dev/null and b/gorseller/codex-rehber.png differ
diff --git a/gorseller/uzak-cli-baglandi.png b/gorseller/uzak-cli-baglandi.png
new file mode 100644
index 0000000..6c160a7
Binary files /dev/null and b/gorseller/uzak-cli-baglandi.png differ
diff --git a/gorseller/uzak-cli-web.png b/gorseller/uzak-cli-web.png
new file mode 100644
index 0000000..8f8ae8d
Binary files /dev/null and b/gorseller/uzak-cli-web.png differ