Numex CLI tanıtım README'si ve görseller

README.md

@@ -1 +1,119 @@
-# numex-cli
+<div align="center">
+
+<img src="gorseller/banner.png" alt="Numex CLI — Terminalinde Türkçe konuşan bir ajan" width="100%">
+
+# ⌨️ Numex CLI
+
+### Terminalinde Türkçe konuşan, otonom bir kod ajanı.
+
+[![npm](https://img.shields.io/badge/npm-@numexai/cli-00C9A7?style=for-the-badge)](https://www.npmjs.com/package/@numexai/cli)
+[![Sürüm](https://img.shields.io/badge/CLI-v3.3.10-0A1628?style=for-the-badge)](https://codex.numexai.com.tr)
+[![Codex](https://img.shields.io/badge/ailesi-Numex_Codex-0A1628?style=for-the-badge)](https://github.com/mobilcep/numex-codex)
+
+</div>
+
+---
+
+```bash
+npm i -g @numexai/cli
+numex login
+numex "koyu temalı bir yapılacaklar uygulaması yap"
+```
+
+Numex CLI, [Numex Codex](https://github.com/mobilcep/numex-codex)'in terminaldeki yüzü. Karmaşık işlerde
+4 uzmanlı **Konsey** (Mimar · Kodlayıcı · Denetçi · Tasarımcı) ile çalışır ve **kanıtsız "bitti" demez** —
+[Konsey nasıl çalışır? →](https://github.com/mobilcep/numex-codex/blob/main/docs/konsey.md)
+
+**Terminal ve IDE'ler için Türkçe, otonom, ajan tabanlı kodlama asistanı.**
+Lisans: MIT · Paket: `@numexai/cli`
+
+![Numex Codex CLI açılış ekranı](gorseller/cli-codex-acilis.png)
+*`numex` → Terminal sohbeti: Selçuklu yıldızı logosu, sunucu, proje kökü, sürüm, mod ve model bilgisi.*
+
+## Kurulum
+
+```bash
+# npm (Node.js 18+)
+npm install -g @numexai/cli
+
+# Windows tek satır (PowerShell)
+irm https://www.numexai.com.tr/install-cli.ps1 | iex
+
+numex --version
+numex basla     # tarayıcıda giriş + başlangıç menüsü
+```
+
+![CLI kurulum sayfası](gorseller/cli-sayfa.png)
+
+## Temel komutlar
+
+| Komut | Ne yapar? |
+|---|---|
+| `numex` | Etkileşimli REPL (terminal sohbeti) |
+| `numex basla` | Giriş + menü |
+| `numex login` | Hesaba giriş |
+| `numex "<görev>"` | Tek seferlik görev: `numex "React e-ticaret arayüzü oluştur"` |
+| `numex plan "<görev>"` | **Mimar planlayıcı** — kod değiştirmeden plan üretir |
+| `numex mission "<görev>"` | **Uzun süreli otonom misyon** — izole sandbox worktree'lerde |
+| `numex undo` | Son turu tek tıkla geri al |
+| `numex --offline "<görev>"` | Yerel Ollama ile çevrimdışı mod |
+| `numex --api-key nx_live_…` | API anahtarı ayarla |
+| `numex --devam` | Son oturumdan devam |
+| `/model fast \| pro \| code` | Aktif profili kilitle |
+
+## Uzaktan PC köprüsü
+
+Telefonunuzdan veya başka bir cihazdan **kendi bilgisayarınıza** klasör oluşturun, dosya yazın,
+komut çalıştırın.
+
+```bash
+numex uzak             # köprüyü başlat (terminal açık kalsın)
+numex uzak install     # arka plan servisi — terminal kapansa da çalışır, sistem tepsisinde ikon
+numex uzak pause       # duraklat
+```
+
+![numex menüsü](gorseller/cli-menu.png)
+
+![Uzaktan CLI — PC bağlandı](gorseller/uzak-cli-baglandi.png)
+
+![Tarayıcıdan PC'ye komut gönderme sayfası](gorseller/uzak-cli-web.png)
+
+Ardından web'deki **developers/remote** sayfasından yazın. Bağlantıda cihaz ID'si ve sohbet linki
+terminalde görünür.
+
+## Öne çıkan mühendislik
+
+| Özellik | Açıklama |
+|---|---|
+| ✂️ **Surgical Fast-Patching** | Unified diff hunk ve satır aralığı çapalarıyla cerrahi kod değişiklikleri — dosyanın tamamını yeniden yazmaz. |
+| 🛰️ **Live Subshell Intercept** | Arka plandaki node/vite/npm süreç hatalarını ~2 saniyede yakalar ve kendini toparlar. |
+| 🌳 **Tree-View Live Progress** | Görev adımlarını canlı ağaç görünümünde gösterir. |
+| 🚦 **FinishGate** | Görev "bitti" sayılmadan önce **canlı kanıt** ister: HTTP 200, birim testleri, DOM kontrolleri. |
+| 🔎 **RAG kod indeksleme** | BM25 + AST grafiğiyle kod tabanında anlamlı arama. |
+| 🔌 **MCP istemcisi** | Model Context Protocol ile dosya sistemi ve git araçları (`mcp.json`). |
+| 🧑‍🤝‍🧑 **İnsan-yoldaş modu** | "Önce anlaşalım, sonra yapalım": otonom modda bile onay alır. |
+| 🧾 **Denetim izi & checkpoint** | Her tur kaydedilir; geri alınabilir. |
+| 🔀 **Git entegrasyonu** | Commit, PR açma, issue → PR hattı. |
+
+## Kişilik
+
+Numex Codex'in kişilik tanımı: *"Önce insan, sonra iş yapan."* Kullanıcıyı dinler, "şunu mu demiştin?"
+diye sorar, yol haritasını birlikte çizer, hata yaparsa kabul edip yol gösterir. Kullanıcının
+ruh halini (stres, yorgunluk, heyecan) fark edip tempo ayarlar.
+
+## Kimler için?
+
+- Terminalde yaşayan geliştiriciler
+- Türkçe açıklama ve Türkçe kod yorumu isteyen ekipler
+- Bilgisayarına uzaktan (telefondan) iş yaptırmak isteyenler
+- CI/CD ve otomasyon hatlarına ajan eklemek isteyenler ([SDK](https://github.com/mobilcep/numex-sdk))
+
+---
+
+<div align="center">
+
+**Numex Ailesi** · [Numex AI](https://numexai.com.tr) · [Codex](https://github.com/mobilcep/numex-codex) · [Okul](https://github.com/mobilcep/numex-okul) · [Market](https://market.numexai.com.tr) · [Numexpedia](https://github.com/mobilcep/numex-pedia) · [Hub](https://github.com/mobilcep/numex-hub) · [Forge](https://github.com/mobilcep/numex-forge) · [API](https://github.com/mobilcep/numex-api) · [SDK](https://github.com/mobilcep/numex-sdk) · [Pusulam](https://github.com/mobilcep/pusulamx) · [PC Doktoru](https://github.com/mobilcep/pcdoktoru)
+
+*İnsanı önce koyan Türk yapay zekâsı* 🇹🇷 · [Tüm ekosistem →](https://github.com/mobilcep/numex_nedir)
+
+</div>