Kodlama ajanınıza bir fonksiyonun nerede çağrıldığını sorun ve olanları izleyin. grep yapar, üç dosya okur, farklı bir desenle yeniden grep yapar, dört dosya daha okur ve sonunda doğru yanıtı verir; bu arada bağlamını, oturum bittiğinde unutacağı kaynak kodla doldurmuştur. Bir takip sorusu sorun, her şeyi baştan yapar.
codebase-memory-mcp bu döngüyü ortadan kaldırıyor. 41.536 yıldızlı, MIT lisanslı ve C ile yazılmış bu araç, bu yılın ajan araçları dalgasında çalışma şeklinizde en az değişiklikle en iyi getiriyi sunan seçenek. Bir ajana kodunuzun hafızasını kazandırıyor. Ekibinize işin hafızasını kazandırmıyor; bunlar birbirinden farklı problemler.
TL;DR
Bu, kodlama ajanlarını genişleten açık kaynak araçlar derlememizdeki beş derinlemesine incelemeden biri.
codebase-memory-mcp bir depoyu fonksiyonlar, sınıflar, çağrı zincirleri ve rotalardan oluşan kalıcı bir bilgi grafiği olarak indeksler, ardından yapısal soruları grep yapmak yerine grafikten yanıtlar. Proje, grafik üzerinden beş yapısal sorguyu yaklaşık 3.400 token, dosya dosya ilerleyen yöntemde ise yaklaşık 412.000 token olarak ölçüyor. Tek bir yerel ikili dosya; çalışma zamanı ya da API anahtarı gerektirmiyor, tamamen yerel çalışıyor ve her MCP istemcisiyle uyumlu. Önce onu kurun. Sonra ajanlarınızın yaptıklarının kaydının nerede tutulacağına ayrıca karar verin.
Ne yapıyor
Ayrıştırma, 160'tan fazla dilde tree-sitter üzerinden yürüyor; Python, TypeScript ve JavaScript ailesi, Go, Java, Rust, C# ve C++ gibi çekirdek bir grup için anlamsal tip çözümlemesi de ekleniyor. Sonuç; arama, çağrı zinciri izleme, mimariye genel bakış, etki analizi, ölü kod tespiti, grafik sorguları ve servisler arası HTTP bağlantılandırmayı kapsayan 15 MCP aracı olarak sunuluyor. Model Context Protocol konuşan her istemci bunu kullanabiliyor ve proje 45 desteklenen ajan yüzeyi listeliyor.
| Ölçüm | Bildirilen |
|---|---|
| Beş yapısal sorgu | ~3.400 token'a karşı dosya dosya ~412.000 |
| Hakem değerlendirmesinden geçmiş karşılaştırma | 10 kat daha az token, 2,1 kat daha az araç çağrısı, %83 yanıt kalitesi |
| Linux çekirdeği indeksi | 28M satır, 75K dosya, 3 dakika |
| Yapısal sorgu gecikmesi | 1 ms'nin altında |
Bu iki token rakamını birlikte okuyun. %99'luk azalma, grafiğin en iyi senaryosu olan beş yapısal sorguya ait. 31 depo üzerindeki ön baskı rakamı ise 10 kat. 10 kat üzerinden planlayın, daha iyisini çıkarsa bonus sayın.
Kurulum
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
Windows için bir PowerShell kurulum betiği var ve proje, çalıştırmadan önce okumanızı öneriyor. Kurulum betiği kodlama ajanlarınızı algılar ve MCP girdilerini yazar. Ajanı yeniden başlatın ve projeyi indekslemesini söyleyin.
İlk günden uygulamaya değer iki ayar:
codebase-memory-mcp config set auto_index true
codebase-memory-mcp --ui=true --port=9749
Grafik görüntüleyici ikili dosyanın içinde geliyor ve indeksin beklediğiniz her şeyi kapsayıp kapsamadığını kontrol etmek için faydalı bir sağlama.
Projenin kendi belgelerinde yer alan ve her biri otuz saniyeye değer iki uyarı var. Microsoft Defender bir sürüm ikili dosyasını yanlış pozitif olarak işaretleyebilir; proje, yaklaşık 62 motorun tipik olarak 61'inin temiz sonuç verdiğini ve aynı tespit ailesinin GitHub CLI ile Microsoft'un kendi Go araç zincirini de vurduğunu belirtiyor. Ayrıca araç kod tabanınızı okur ve ajan yapılandırma dosyalarınıza yazar; bu onun işi ve açıkça belirtilmiş. Kurulum betiğini bir kabuğa aktarmadan önce okuyun.
Neden önce bu
Mevcut araç dalgasındaki diğer her şey, çalışma şeklinizi değiştirmenizi istiyor. Rol kütüphaneleri nasıl prompt yazdığınızı değiştiriyor. Paralel worktree'ler nasıl organize olduğunuzu değiştiriyor. Web erişimi ne istediğinizi değiştiriyor.
Bu araç ise hiçbir şeyi değiştirmiyor ve her oturumu daha ucuz hale getiriyor. Öğrenmeniz gereken bir alışkanlık yok.
Hafife alınan kısım kalite etkisi. Dosya okumaya 400.000 token harcayan bir ajanın probleminiz üzerine düşünmek için o kadar az alanı kalır ve başta okuduklarını hatırlaması uzun bir oturumda zayıflar. Grafikten yanıt vermek ise bağlamı boş tutar.
Bu değişim ne sorduğunuzda kendini gösterir. Daha önce 50.000 token ve iki dakikaya mal olduğu için kaçındığınız sorular artık neredeyse bedava. Bir imza değişikliğinden önce yapılan etki analizi, "sanırım bu güvenli" ifadesini bir listeye dönüştürür. Yabancı bir depoda çağrı zincirini izlemek, giriş noktasını bulma umuduyla beş dosyayı aşağıdan yukarıya okumaktan iyidir.
Kodun hafızası, işin hafızası değildir
İşte sınır bu ve oldukça keskin.
Grafik kodunuzdan oluşturulur, dolayısıyla kodunuzun ne olduğunu bilir. Yeniden deneme yardımcı fonksiyonunun ödeme istemcisini çağırdığını söyleyebilir. Ancak bekleme süresinin neden temmuzda değiştiğini, buna kimin karar verdiğini, alternatifin ne olduğunu ya da birinin bunu gözden geçirip geçirmediğini söyleyemez. O geçmiş, artık var olmayan bir terminal oturumunda yaşadı.
Ekipler bunu tuhaf bir asimetri olarak hissediyor: ajanın kod tabanına dair hafızası ekipteki herhangi bir insandan daha iyi, ama onu ortaya çıkaran kararlara dair hiçbir hafızası yok.
İndeks ayrıca makineye özel. Tek bir hesabın altındaki bir önbellek dizininde yaşar, bir koordinasyon daemon'u aracılığıyla yerel oturumlarınız arasında paylaşılır ve o makinenin sınırında durur.
İş kaydı nerede tutulur
Görev (Task), Sharkly'deki ana iş birimidir. İsteği, bağlamı, yürütmeyi, engelleri ve sonucu özel prompt'lara ve terminal oturumlarına bölmek yerine tek bir paylaşılan yerde taşır.
Her parçanın tek bir görevi var. Ajan, işin nasıl ele alınacağını tanımlar. Computer, ana makineyi ve yerel kaynakları sağlar. Runtime, orada zaten kurulu olan kodlama aracını kullanarak gerçek ajan oturumunu yürütür. Görev ise paylaşılan kayıt olarak kalır.
Bu ayrım eşleştirmeyi somut hale getirir. İndeks, bir Computer üzerindeki yerel kaynaktır; dolayısıyla indekslenmiş bir depoyu barındıran Computer, üç dakikalık soğuk bir başlangıç yerine sıcak bir grafiğin bulunduğu makinedir. Ajan kaydedilmiş bir yapılandırmadır; böylece ajanınızın indekse ve doğru izinlere sahip olduğu kurulum her makinede yeniden oluşturulmak yerine yeniden kullanılır. Yürütme, engeller, sonuçlar ve takip tartışmaları ise görev zaman çizelgesine döner; bir değişikliğin ardındaki gerekçe de burada yaşamaya devam eder.
Sharkly, Claude Code'un, Codex'in ya da codebase-memory-mcp'nin yerini almaz. Onların etrafına paylaşılan görev, Computer, bağlam, kontrol ve inceleme katmanını ekler. Model kullanımı, o araçlarda yapılandırılmış abonelikler veya API anahtarları üzerinden devam eder.
İşte kombinasyon kod hafızası artı iş hafızası. Biri ajana depoyu hatırlama yetisi kazandırır. Diğeri ekibe ajanların o depoda ne yaptığını hatırlatır.
Hangisine ne zaman ihtiyaç duyarsınız
Ekip büyüklüğünüz ne olursa olsun codebase-memory-mcp'yi şimdi kurun. Yereldir, iş akışı değişikliği gerektirmez ve maliyet düşüşü yirmi geliştiriciye olduğu kadar tek geliştiriciye de yarar sağlar.
Gerekçenin oturumdan daha uzun yaşaması gerektiğinde paylaşılan bir iş sistemi ekleyin: inceleme sürümden önce yapılıyorsa, aynı depoya birden fazla kişi dokunuyorsa ya da üç ay sonra biri bu değişiklik neden yapıldı diye soracaksa. Bir grafik kodun ne yaptığını yanıtlar. Neden yaptığını asla yanıtlamaz.
Ajanlar araştırır, yürütür, test eder ve raporlar. İnsanlar yön belirler, yetki verir ve sonucu kabul eder.
Sıkça sorulan sorular
Claude Code dışındaki ajanlarla çalışıyor mu? Evet. Bir MCP sunucusu olduğu için her MCP istemcisi çalışır ve proje, Cursor, Codex, Windsurf, OpenCode ve Aider dahil 45 desteklenen ajan yüzeyi listeliyor.
Kodum makinemden çıkıyor mu? Hayır. İşleme tamamen yereldir ve proje, kendi adına hiçbir ağ isteği yapmadığını, arka planda güncelleme kontrol etmediğini belirtiyor. Güvenmek yerine doğrulamak isterseniz kaynak kod ortada.
%99'luk token azalması gerçekçi mi? O rakam beş yapısal sorguya ait, yani en iyi senaryo. 31 depo üzerindeki hakem değerlendirmesinden geçmiş rakam ise 10 kat daha az token ve 2,1 kat daha az araç çağrısı. 10 kat üzerinden planlayın.
Ne kadar büyük bir depoyu işleyebiliyor? Belirtilen üst sınır senaryosu, üç dakikada 28 milyon satırlık Linux çekirdeği. Sıradan uygulama depoları milisaniyeler içinde indekslenir.
Birden fazla ajan aynı anda çalıştığında faydası olur mu? Evet, hem de normalden fazla. Aynı depoyu grep eden beş ajan, beş kat israf demektir. Her Görev çalışması yine kendi izole worktree'sine sahip olur; yapısal indeks ise Computer üzerinde paylaşılır.
Kısa özet
Bu, 2026 dalgasındaki en az görünür araç ve getirisi en yüksek olan. Tek bir yerel ikili dosya, iş akışı değişikliği yok ve bir ajanın grep yapmak zorunda kalmaması gereken soruları yanıtlarken harcadığı tokenlarda ölçülmüş bir büyüklük mertebesi düşüş. Kurun, projenizi indeksleyin ve ne oluşturduğunu görmek için grafik görüntüleyiciyi bir kez açın.
Sonra sınırı net biçimde bilin. Depoyu hatırlar, işi değil; bir değişikliğin ardındaki kararlar da onları tutan bir şey olmadıkça oturumla birlikte ölür. Sharkly tam da bunu tutar: Görev paylaşılan kayıttır, yürütme zaten ödeme yaptığınız runtime'lar üzerinden bağladığınız Computer'larda çalışır ve sonuçlar bir insanın inceleyip kabul edebileceği bir yere döner.
