AI kodlama ajanları için yerel CLI aracı: Dosyalarınızı 'görmesini' sağlayın

AI destekli kodlama araçları son yıllarda geliştiricilerin en önemli yardımcıları arasında yer alıyor. Fakat bu araçların dosya okuma işlemleri, özellikle büyük projelerde ciddi performans ve maliyet sorunlarına yol açabiliyor. Geliştirici olarak ben de bu problemi derinlemesine inceledim ve yerel bir CLI aracı olan unerr’ı geliştirerek AI ajanlarının dosyaları "görmesini" sağlayan bir çözüm sundum.

AI ajanlarının en büyük handikapı: Kör dosya okumaları

AI kodlama ajanları (Claude Code, Cursor vb.) genellikle bir kod tabanını analiz etmek istediklerinde dosyaları baştan sona okumak zorunda kalıyor. Bu durum üç temel soruna yol açıyor:

• Token maliyetlerinin aşırı artması
• Bağlam pencerelerinin hızla dolması ve performans kaybı
• Gereksiz kod satırlarının okunmasıyla oluşan gecikmeler

Örneğin, 500 satırdan oluşan bir dosyada sadece 50 satırın ilgili olduğunu varsayalım. AI aracının bu dosyayı tamamen okuması, hem zaman hem de kaynak kaybına neden oluyor. unerr ise bu sorunu dosyaları okumadan önce yapısal olarak analiz ederek AI ajanlarına yalnızca ihtiyaç duydukları içeriği sunuyor.

unerr nasıl çalışıyor? Yerel zekanın gücü

unerr, Model Context Protocol (MCP) üzerinden AI ajanlarıyla entegre olan yerel bir komut satırı aracı. Temel çalışma prensibi şu şekilde özetlenebilir:

1. Hızlı dizin oluşturma: Projenizin tamamını saniyeler içinde taramak için Tree-sitter adlı AST (Abstract Syntax Tree) analiz aracını kullanır.
2. Yerel veritabanı ile optimize edilmiş erişim: CozoDB adlı yerel bir veritabanı üzerinde yapısal verileri depolayarak, AI ajanlarının sadece ilgili kod parçalarına erişmesini sağlar.
3. Gerçek zamanlı bağlam sunumu: AI aracı bir dosyaya erişmek istediğinde, unerr doğrudan ilgili fonksiyonları, bağımlılıkları ve çağrıları aktarır — böylece AI ajanının gereksiz verileri okumasına gerek kalmaz.

# unerr’ı global olarak kurun
npm install -g @unerr-ai/unerr

# Projenizi tarayın ve yerel bir sunucu başlatın
unerr index

Bu işlemler yerel olarak gerçekleştiği için herhangi bir API anahtarı, bulut hizmeti veya hesap oluşturma gereksinimi bulunmuyor. Tüm veriler ve işlemler yalnızca sizin makinenizde kalıyor.

Gerçek dünya testleri: Aracın performansı nasıl?

unerr’ı geliştirirken karşılaşılan en büyük zorluklardan biri, farklı işletim sistemlerinde ve Node.js ortamlarında tutarlı çalışmasını sağlamaktı. Bu nedenle, geliştirme sürecinin son aşamasında topluluktan yardım istedim.

Eğer siz de unerr’ı denemek isterseniz, aşağıdaki adımları izleyebilirsiniz:

• Kurulum testi: npm install -g @unerr-ai/unerr komutunun farklı işletim sistemlerinde (Windows, macOS, Linux) ve Node.js sürümlerinde sorunsuz çalışıp çalışmadığını kontrol edin.
• Bağlam optimizasyonu testi: AI aracınızın projelerinizdeki dosyaları hangi düzeyde anladığını ve ne kadar hız kazandığını gözlemleyin.
• Kullanım deneyimi: unerr’ın AI ajanlarınızla entegrasyonunun sorunsuz olup olmadığını ve aracın performansını artırıp artırmadığını değerlendirin.

Eğer herhangi bir hata, performans sorunu veya kullanım güçlüğüyle karşılaşırsanız, lütfen geri bildirimlerinizi paylaşın. Bu geri bildirimler, aracın daha da geliştirilmesine büyük katkı sağlayacak.

Gelecekte neler değişecek? AI geliştirme araçlarının yeni çağı

unerr gibi yerel zeka odaklı araçlar, AI destekli geliştirme süreçlerini daha verimli, şeffaf ve maliyet-etkin hale getiriyor. Gelecekte, benzer teknolojilerin yaygınlaşmasıyla birlikte AI ajanlarının yalnızca kod okumakla kalmayıp, projelerin yapısını daha derinlemesine anlayarak daha akıllı öneriler sunması bekleniyor.

Eğer siz de AI destekli geliştirme araçları kullanıyorsanız, unerr’ı deneyerek veri gizliliğinizi korurken performansınızı artırabilirsiniz. Topluluktan gelen geri bildirimler, bu aracın gelecekteki sürümlerinin daha da güçlenmesine yardımcı olacak.

Sizce AI ajanlarının dosya okuma sorununa başka hangi yerel çözümler getirilebilir? Deneyimlerinizi ve önerilerinizi yorumlarda paylaşın!