diff --git a/README.md b/README.md index cdbac6b..aebdb79 100644 --- a/README.md +++ b/README.md @@ -1 +1,119 @@ -# numex-cli \ No newline at end of file +
+ +Numex CLI — Terminalinde Türkçe konuşan bir ajan + +# ⌨️ 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) + +
+ +--- + +```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 ""` | Tek seferlik görev: `numex "React e-ticaret arayüzü oluştur"` | +| `numex plan ""` | **Mimar planlayıcı** — kod değiştirmeden plan üretir | +| `numex mission ""` | **Uzun süreli otonom misyon** — izole sandbox worktree'lerde | +| `numex undo` | Son turu tek tıkla geri al | +| `numex --offline ""` | 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)) + +--- + +
+ +**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) + +
diff --git a/gorseller/banner.png b/gorseller/banner.png new file mode 100644 index 0000000..8bc8dd6 Binary files /dev/null and b/gorseller/banner.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/cli-sayfa.png b/gorseller/cli-sayfa.png new file mode 100644 index 0000000..1f3ebfb Binary files /dev/null and b/gorseller/cli-sayfa.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