Graphify: projeni bir bilgi grafına çeviren, Claude Code'a dosya dosya okumak yerine grafı sorgulatan açık kaynak araç

Repo Apache 2.0 lisanslı ve tamamen ücretsiz. Arkasındaki şirket ayrıca graphify.com'da arka planda sürekli güncellenen, ücretli bir platform da sunuyor; ama burada anlattığım komut satırı aracı onunla bağlantılı değil, tek başına çalışıyor.

Aşağıda fazladan olan şey şu: paket adındaki tuzak, Windows'ta kurulumu bozan PATH sorunu, asistanın grafı gerçekten kullanmasını sağlayan ayrı komut ve token tasarrufu iddiasının hangi projede tuttuğu.

Claude Code büyük bir projede bir soruya cevap ararken genelde grep atıp dosyaları tek tek açıyor. Her açılan dosya context'e giriyor, yani hem token yakıyor hem de asistan bağlantıları kaçırabiliyor. Graphify bu işi bir kere yapıp sonucu bir graf olarak kaydediyor: hangi fonksiyon neyi çağırıyor, hangi dosya neyi import ediyor, hangi doküman hangi koda atıfta bulunuyor.

Bir vektör veritabanı değil; embedding yok. Gerçek bir graf, yani iki şeyin arasındaki yolu adım adım izleyebiliyorsun. Her bağlantının yanında da etiket var: EXTRACTED kaynakta açıkça yazan, INFERRED aracın çıkarımı. Neyin okunduğunu, neyin tahmin edildiğini ayırt edebiliyorsun.

Python 3.10 veya üstü gerekiyor. Önerilen yol uv; Windows'ta uv yoksa önce onu kur.

winget install astral-sh.uv

uv tool install graphifyy
graphify install

Sonra Claude Code'u aç ve proje klasöründe şunu yaz:

/graphify .

PDF, Word/Excel ya da video dosyalarını da grafa katmak istersen ek paketleri isteyerek kuruyorsun; örneğin uv tool install "graphifyy[pdf]" ya da hepsi için "graphifyy[all]".

Çoğu kişinin kaçırdığı adım bu. Graf oluştu diye Claude Code onu kendiliğinden kullanmıyor; eski alışkanlığıyla grep atmaya devam ediyor. Graf kurulduktan sonra projede bir kere şunu çalıştır:

graphify claude install

Bu, asistan arama yapmadan ya da dosya okumadan hemen önce devreye giren bir hook kuruyor ve onu önce grafa sormaya yönlendiriyor. Cursor, Codex ve diğerleri için komut farklı (graphify cursor install gibi); tam liste repoda.

Graf zamanla eskiyor. Her commit'te kendini güncellemesi için hook kurabilirsin; git pull sonrasında ise elle güncellemen gerekiyor:

graphify hook install   # bir kere: her commit ve branch değişiminde yeniden kurar
graphify update .       # git pull sonrasında

Asistan bunları kendisi çağırıyor, ama terminalden sen de sorabilirsin:

graphify query "kimlik doğrulama veritabanına nereden bağlanıyor?"
graphify path "UserService" "DatabasePool"
graphify explain "RateLimiter"

GRAPH_REPORT.md dosyasına da bir kere göz at. En çok bağlantısı olan kavramları, farklı klasörler arasındaki beklenmedik bağlantıları ve grafın cevaplayabileceği örnek soruları listeliyor. Yeni girdiğin bir projeyi anlamak için en hızlı yol bu.