numexai/numex-codex

Fork 0

mirror of https://github.com/numexai/numex-codex.git synced 2026-09-25 13:32:17 +00:00

numexai 910318f5af Linkler: mobilcep/ → numexai/ (depolar organizasyona taşındı)

2026-09-24 03:54:13 +03:00

12 KiB

Raw Blame History

Numex Codex

Editörüne Türkçe düşünen bir kod ajanı.

İste, yazsın, çalıştırsın — iş bitene kadar.

🇹🇷 Türkçe · 🇬🇧 English

Numex Codex, Numex AI'ın kod ajanıdır. Ona Türkçe ne istediğini söylersin; plan çıkarır, kodu yazar, çalıştırır, test eder ve ancak çalıştığını kanıtladığında "bitti" der. Karmaşık işlerde tek başına değil, dört uzmandan oluşan bir Konsey ile çalışır.

📌 Bu depo Numex Codex'in tanıtım, dokümantasyon ve topluluk deposudur. Hata bildirimleri, öneriler ve tartışmalar burada; sürümler codex.numexai.com.tr'den indirilir. Açık kaynak SDK: numex-sdk.

🚪 Üç kapı, tek ajan

	Nerede?	Kurulum	Kimin için?
🧩 Codex IDE	Windows masaüstü	İndir — v2.9.59, ~162 MB, tamamen Türkçe	Günlük profesyonel geliştirme
🧩 VS Code eklentisi	Mevcut VS Code'un	Eklentiyi kur + CLI'ye giriş yap	Alışkanlığını bozmadan
⌨️ Codex CLI	Terminal	`npm i -g @numexai/cli`	Terminal, otomasyon, uzak sunucu, CI
🌐 Codex Web	Tarayıcı	Yok	Kurulumsuz, "sohbet eder gibi" hızlı proje

Hepsi aynı Numex Çekirdeği'ni kullanır: terminaldeki komut ile editördeki buton birebir aynı davranır. Programatik erişim için: Numex SDK.

⚡ Hızlı başlangıç

$ npm i -g @numexai/cli
$ numex login
✓ Giriş başarılı — hoş geldin 👋
$ numex
◇ Numex Codex — Türkçe kod ajanı hazır

İlk görevini ver:

numex "koyu temalı, localStorage kullanan bir yapılacaklar uygulaması yap"

🏛️ Konsey — 4 uzman, tek görev

Çoğu kod ajanı tek bir modelin her şeyi aynı anda yapmasına dayanır: planlar, yazar, test eder ve "bitti" der — kendi ödevini kendi notlandıran bir öğrenci gibi. Codex'te karmaşık işler bir Konsey'e verilir; her üyenin tek bir işi ve sınırlı bir yetkisi vardır.

Üye	Görevi	Yazabilir mi?
📐 Mimar	Klasör yapısı, veri modeli, dosya dosya fonksiyon planı	❌ Sadece plan
💻 Kodlayıcı	Plana göre tam ve çalışan kodu yazar — iskelet, TODO yok	✅ Tek yazıcı
🛡️ Denetçi	Önce "doğru şeyi mi yaptık?", sonra test ve doğrulama	❌ Sadece test/rapor
🎨 Tasarımcı	Arayüz ve kullanıcı deneyimi cilası	⚠️ Sadece CSS/HTML

flowchart LR
    U([İstek]) --> A[📐 Mimar]
    A --> C[💻 Kodlayıcı]
    C --> H[🔁 Self-Healing]
    H --> D[🛡️ Denetçi]
    H --> T[🎨 Tasarımcı]
    D -->|sorun| C
    D --> G{🚦 FinishGate}
    T --> G
    G -->|kanıt ✓| OK([✅ Onay])
    G -->|kanıt yok| H

Tek yazıcı kuralı: Kodu yalnızca Kodlayıcı yazar; çakışma imkânsızdır.
Konu sapması kontrolü: Mimar'ın planı isteğinden saparsa Kodlayıcı planı değil senin isteğini esas alır.
Doğru iş için doğru ekip: Basit bir düzeltmede konsey toplanmaz; işin büyüklüğüne göre 0, 2, 3 ya da 4 üye çağrılır ve token bütçesi önceden kontrol edilir.
Kendin çağır: "konseyi topla", "ajanları çağır", "ekibi topla", "hep birlikte bak".
Dürüst rapor: Sonunda ne olduğunu düz Türkçe anlatan bir konsey raporu; çözülemeyen sorun varsa açıkça söylenir.

👉 Ayrıntılı anlatım: Konsey nasıl çalışır?

🔀 Dört çalışma modu

Mod	Ne yapar?	Örnek
💬 Sohbet	Soru-cevap; dosya okur, açıklar, önerir	"Bu proje ne yapıyor?"
🗺️ Plan	Kod değiştirmeden mimari plan ve adım listesi	"Ödeme modülü nasıl eklenir?"
🤖 Otonom	Plan → onay → uygula → doğrula döngüsünü kendisi yürütür	"Testleri yeşile çek"
🐞 Hata Avcısı	Log, terminal çıktısı ve koddan kök nedeni bulur	"Uygulama açılıyor ama ses yok"

Her adım görünür: "🔍 7 adım · 2 dosya okundu · 2 klasör tarandı · 63 eşleşme".

🚦 Kanıtsız "bitti" yok: FinishGate

Kod ajanlarının klasik hatası: "Tamamlandı!" deyip çalışmayan kod teslim etmek. Codex'te görev ancak canlı kanıtla kapanır:

✅ Sunucu gerçekten HTTP 200 dönüyor mu?
✅ Testler geçiyor mu?
✅ Tarayıcıda DOM beklenen öğeleri içeriyor mu? (Omni-Vision: headless tarayıcıyla görsel kontrol)

Kanıt yoksa ajan Self-Healing döngüsüne döner: sözdizimi, yapı, veri bütünlüğü ve parantez dengesi kontrol edilir, hata düzeltilir, tekrar denenir. Ajan takılırsa StuckDetector devreye girip sana ya da web aramasına döner.

🧩 Codex IDE — "Numex Çözüm"

VS Code tabanlı masaüstü editör. Sağ paneldeki asistanın adı Numex Çözüm.


✍️ Satır içi düzenleme	`Ctrl+K` → "bunu async yap"
⏭️ Sonraki düzenleme	Bir değişiklik yaparsın, ilgili sonraki yeri tahmin eder → `Tab`
🔍 Kod Lens	Her fonksiyonun üstünde `◆ Numex: … hakkında sor`
🧠 Anlamsal arama	"Ödeme nerede doğrulanıyor?" — embedding indeksiyle
🖼️ Görselden arayüz	Ekran görüntüsü → çalışan kod
🖥️ Terminal	Doğal dilden komut üret · terminal çıktısını sohbete gönder
🔀 Git	Commit mesajı üret · değişiklikleri AI ile incele · PR aç
🤖 Ajanlar	Arka plan ajanı · bulut ajanı · gömülü tarayıcı · Design Mode · Composer
🌍 Uzak	SSH ve WSL ile uzak sunucuya bağlan
⚙️ Ayarlar	Model & sağlayıcı · sohbet & onay · Mizah Modu · RAG · tema · token kullanımı

Tüm komutlar ve kısayollar: docs/komutlar.md

⌨️ Codex CLI

numex                                  # terminal sohbeti
numex "görev"                          # tek seferlik görev
numex plan "ödeme modülü ekle"         # sadece plan, kod değişmez
numex mission "testleri yeşile çek"    # izole çalışma alanında uzun otonom misyon
numex undo                             # son turu tek tıkla geri al
numex --offline "…"                    # yerel Ollama ile internetsiz
/model fast | pro | code               # profili kilitle

✂️ Cerrahi yama — dosyayı baştan yazmaz, diff parçalarıyla hedefli değişiklik
🛰️ Subshell yakalama — arka plandaki npm/vite/node hatalarını ~2 sn'de yakalar, toparlanır
🌳 Canlı ağaç ilerlemesi — görev adımları ağaç görünümünde
🔎 BM25 + AST kod indeksi · 🔌 MCP istemcisi (dosya sistemi, git)

📱 Uzaktan PC — telefondan bilgisayarına

numex uzak install    # arka plan köprüsü; terminal kapansa da çalışır, sistem tepsisinde ikon

Sonra numexai.com.tr/developers/remote sayfasından Google ile giriş yap, yeşil noktalı PC'ni seç, yaz: klasör oluştur, dosya yaz, komut çalıştır.

🌐 Codex Web

"Chat kutusuna ne istediğini yaz. Agent dosyaları otomatik oluşturur, editöre yazar, önizlemeyi günceller. Tek buton yok, tek tıklama yok — sadece yaz ve izle."

Solda dosya gezgini + Monaco editörü, sağda ajan sohbeti, altta terminal, ayrı önizleme
Şablonlar: Başlangıç · Todo · Hesap · Dashboard · E-ticaret · Blog · Manav
Hedef platform (Web / API / Masaüstü) ve proje türü (Muhasebe, POS, Oyun, E-ticaret…) seçimi
Ajan değişiklik kartı: Kabul Et / Fark / Reddet
Kaydet · ZIP indir · URL'den aç · 🚀 Yayınla — tek tıkla herkese açık adres

🧠 Şeffaf hafıza: `.numex/`

Codex ne bildiğini ve ne yaptığını gizlemez. Her projede okunabilir bir .numex/ klasörü tutar: RAG indeksi, denetim izi (audit-trail.jsonl), geri alma noktaları, öğrenilen hatalar, misyon durumu ve token kullanımı. Projeye döndüğünde ajan kaldığı yerden devam eder.

👉 docs/numex-klasoru.md

🔐 Güvenlik ve kontrol

Önce anlaşalım, sonra yapalım: Otonom modda bile plan sunar ve onay alır.
Diff önizleme: Her değişiklik kabul/ret için gösterilir.
Geri alma: numex undo, .numex/checkpoints.
Denetim izi: Ajanın çalıştırdığı her komut ve yaptığı her değişiklik kayıtlı.
Kendi bilgisayarında: Ajan dosyalarını senin makinende işler; veriler Türkiye'de, KVKK uyumlu altyapı.

💳 Fiyat

Plan	Codex erişimi
Ücretsiz	Temel CLI
Başlangıç PRO — ₺99/ay	Tam CLI
Numex PRO — ₺399/ay	Tam CLI + API, 128K bağlam, öncelikli kuyruk
Advanced — ₺599/ay	Tam CLI + tam API, 3 hesap, canlı destek

Kota bitince Numex Kredisi; abonelik istemeyenlere zaman bileti (8 saat ₺29'dan). Güncel fiyatlar: numexai.com.tr.

📚 Dokümanlar


🏛️ Konsey nasıl çalışır?	4 uzman, bütçe seviyeleri, FinishGate, konsey raporu
⌨️ Komutlar ve kısayollar	CLI komutları, IDE komut paleti
🧠 .numex klasörü	Ajanın şeffaf hafızası
🌐 Numex ekosistemi	Numex Ailesi'nin tamamı
🧰 Numex SDK	Codex'i kendi kodundan çalıştır

🤝 Topluluk

🐞 Hata mı buldun? → Hata bildir
💡 Fikrin mi var? → Özellik isteği
💬 Codex ile ne yaptın? → Discussions
🔒 Güvenlik açığı → destek@numexai.com.tr (lütfen herkese açık issue açma)

Numex Codex · Numex Ailesi'nin geliştirici kapısı
İnsanı önce koyan Türk yapay zekâsı 🇹🇷

12 KiB Raw Blame History Unescape Escape