README_tr.md

 ▄▀▀▀ █▀▀▄ ▄▀▀▄ █▀▀█ █▀▀▀ █▀▀▄ ▄▀▀▄ ▄▀▀▄ ▀█▀
 █ ▀▄ █▄▄▀ █▄▄█ █▄▄█ █▀▀  █▄▄▀ █  █ █  █  █
 ▀▀▀▀ ▀ ▀▀ ▀  ▀ █    ▀▀▀▀ ▀ ▀▀ ▀▀▀▀ ▀▀▀▀  ▀

GrapeRoot Nedir?

GrapeRoot, siz ve yapay zeka kodlama asistanınız arasında konumlanan açık kaynaklı bir bağlam motorudur. Kod tabanınızın — dosyalar, semboller, içe aktarmalar, çağrı zincirleri — anlamsal bir grafiğini oluşturur ve yapay zekanın görmeden önce her isteme tam olarak doğru kodu önceden yükler.

Sonuç olarak: yapay zekanız tokenlarını keşfetmeye değil, akıl yürütmeye harcar.

Çalıştırırsınız: dgc /path/to/project
              ↓
1. Proje taranır → anlamsal grafik oluşturulur (dosyalar, semboller, içe aktarmalar)
2. Bir soru sorarsınız
3. Grafik ilgili dosyaları belirler → bunları bağlama paketler
4. Yapay zeka sorunuzu + doğru kodu önceden yüklenmiş olarak alır
5. Daha az tur, daha az token, daha iyi yanıtlar

Token tasarrufu bir oturum boyunca birikerek artar. Grafik hangi dosyaların okunduğunu, düzenlendiğini ve sorgulandığını hatırlar — her tur daha ucuza gelir.

Sonuçlar

Birden fazla gerçek kod tabanında (7.700'den fazla dosya) ve 50'den fazla mühendislik istemiyle kıyaslandı:

Görev türüne göre maliyet azalması

Tasarruflar bir oturum boyunca birikerek artar — 3. turda önlenen bir token, sonraki her turda önbellek yeniden faturalandırmasını da engeller. Kalite, yukarıdaki tüm görev türlerinde eşit kalır ya da iyileşir.

Tam kıyaslama metodolojisi ve sonuçları: graperoot.dev/benchmarks

Desteklenen Yapay Zeka Araçları

Desteklenen Programlama Dilleri

TypeScript · JavaScript · Python · Go · Swift · Rust · Java · Kotlin · Scala · C# · Ruby · PHP

Kurulum

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.sh | bash
source ~/.zshrc   # or ~/.bashrc / ~/.profile

Windows (PowerShell):

irm https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.ps1 | iex

Windows (Scoop):

scoop bucket add dual-graph https://github.com/kunal12203/scoop-dual-graph
scoop install dual-graph

Ön koşullar: Python 3.10+, Node.js 18+ ve desteklenen yapay zeka araçlarından biri. Yükleyici eksik araçları otomatik olarak algılar ve bunları yüklemeyi teklif eder.

Kullanım

Önemli: MCP sunucusunun çalıştığından emin olmak için her zaman claude yerine dgc kullanın.

Claude Code

dgc                                      # scan current directory, launch Claude
dgc /path/to/project                     # scan a specific project
dgc /path/to/project "fix the login bug" # start with a prompt

OpenAI Codex CLI

dg                              # scan current directory
dg /path/to/project             # scan a specific project
dg /path/to/project "add tests" # start with a prompt

Etkileşimli Seçici (v3.9.99'da yeni)

graperoot          # shows directory confirm + arrow-key tool picker
graperoot .        # same, picks from current directory
graperoot --version   # print current version
graperoot --update    # force self-update

graperoot ile Tüm Araçlar

graperoot . --cursor          # Cursor
graperoot . --gemini          # Gemini CLI
graperoot . --opencode        # OpenCode
graperoot . --copilot         # GitHub Copilot
graperoot . --openclaw        # OpenClaw
graperoot . --kilocode        # Kilocode
graperoot . --mimocode        # MiMo Code
graperoot /path --gemini "add tests"   # specific project + prompt

Windows

dgc .                          # from inside the project directory
dgc "D:\projects\my-app"       # any drive, any path
dg "C:\work\backend"           # Codex CLI
dgc --gemini "D:\projects\app" # Gemini CLI on Windows

Nasıl Çalışır

1. Grafik taraması — İlk çalıştırmada GrapeRoot, dosyaları, fonksiyonları, sınıfları ve içe aktarma ilişkilerini .dual-graph/ içinde saklanan yerel bir grafiğe çıkarır.
2. Bağlam alımı — Her soru sorduğunuzda grafik en ilgili dosyaları sıralar ve yapay zekanız görmeden önce bunları isteme paketler.
3. Oturum belleği — Okuduğunuz, düzenlediğiniz veya sorguladığınız dosyalar gelecekteki turlarda daha yüksek ağırlık alır. Bağlam birikerek büyür.
4. MCP araçları — Yapay zekanız daha derine inmeye ihtiyaç duyduğunda grafik-bilinçli araçlar (graph_read, graph_retrieve, graph_neighbors) aracılığıyla yine de daha fazla araştırabilir.

Tüm işlemler yereldir. Hiçbir kod makinenizden çıkmaz.

Veri ve Dosyalar

Tüm veriler <proje>/.dual-graph/ dizininde saklanır (.gitignore dosyasına otomatik olarak eklenir):

~/.dual-graph/ dizinindeki genel kurulum:

Yapılandırma

Tümü isteğe bağlıdır; ortam değişkenleri aracılığıyla ayarlanır:

Otomatik Güncelleme

Başlatıcı her çalıştırmada güncellemeleri kontrol eder ve sessizce otomatik olarak güncellenir. Güncellemeyi zorlamak için:

graperoot --update

Otomatik güncellemeyi devre dışı bırakmak için:

graperoot --no-auto-update

Yeniden etkinleştirmek için:

graperoot --auto-update

Mevcut sürüm: 3.10.16

Telemetri

GrapeRoot, hataları düzeltmeye yardımcı olmak için anonim çökme raporları toplar. Gönderilen bilgiler: hata türü, hangi adımın başarısız olduğu, OS/Python sürümü, GrapeRoot sürümü. Asla gönderilmeyen bilgiler: kodunuz, dosya yolları, proje adları veya kişisel veriler.

graperoot --no-telemetry    # disable
graperoot --telemetry       # re-enable

GrapeRoot Pro

GrapeRoot Pro, ileri düzey kullanıcılar için gelişmiş özellikler sunar:

• Kapsamlı görev modu — karmaşık yeniden yapılandırmalar için derin çok dosyalı analiz
• Kullanılmayan dışa aktarma tespiti — kod tabanı genelinde kullanılmayan dışa aktarmaları bulma
• Bağımlılık döngüsü bulucu — döngüsel içe aktarma zincirlerini tespit etme
• Kod tabanları arası arama — birden fazla depo genelinde anlamsal arama
• Geri alma kalkanı — yıkıcı işlemleri koruyan araç-öncesi kancalar

Sorun Giderme

"MCP Server Connection Failed"

Her zaman claude yerine dgc kullanın. dgc, MCP sunucusunu otomatik olarak başlatır.

# Fix:
claude mcp remove dual-graph
dgc   # re-registers everything

Tam sorun giderme kılavuzu

TROUBLESHOOTING.md veya graperoot.dev/docs adresine bakın.

Katkıda Bulunma

Başlatıcı betikler (bin/), Apache 2.0 lisansı altında açık kaynaktır. PR'lar kabul edilir — hata düzeltmeleri, yeni yapay zeka asistan desteği, kurulum iyileştirmeleri, belgeler.

Not: Grafik motoru (graperoot pip paketi) tescilli bir yazılımdır. Bu depodaki başlatıcılar ve araçlar tamamen açık kaynaktır.

Topluluk

Bir sorunuz mu var, hata mı buldunuz ya da geri bildirim paylaşmak mı istiyorsunuz?

Discord'a Katılın →

Yıldız Geçmişi

Lisans

Bu depodaki başlatıcı betikler ve araçlar: Apache License 2.0

graperoot grafik motoru (PyPI): tescilli yazılım. Bkz. graperoot.dev/graperoot-pro.