Pensieve: Cursor ve Claude Code için yerel semantik arama ve MCP
pensieve, macOS üzerinde dosya, git deposu ve agent oturumlarını yerelde indeksleyen MIT lisanslı bir araç; mcp ile coding agent’lara hem semantik hem exact arama sunuyor. Amaç, geniş grep/okuma döngülerini dosya+satır düzeyinde hedefli pasajlarla değiştirmek. Cursor, Claude Code, Codex ve diğer MCP istemcileri destekleniyor; pensieve mcp komutu entegrasyonu açıyor.
Ana Gelişme
Ürün sitesine göre hibrit sorgu: doğal dil, tırnaklı exact phrase, kind:, ext:, in: filtreleri. İndeks ~/.pensieve altında; .env ve anahtar dosyaları atlanıyor. Git blame tabanlı ownership haritaları ve “bus factor” uyarıları, ekip bağlamını agent prompt’una taşımayı hedefliyor.
Performans iddiaları yalnızca yazarın yayınladığı benchmark’lara dayanıyor; bağımsız doğrulama yapılmadı. Pensieve 0.5.6 üzerinde Claude Sonnet / Claude Code ile 72 görev × 4 depo (504–34.847 dosya) senaryosunda raporlananlar:
| Metrik | Pensieve (yazar) | grep odaklı (yazar) |
|---|---|---|
| Doğru dosya | 131/144 | 123/144 |
| Lookup başına tool call | ~2,0 | |
| Lookup maliyeti | ~$0,041 |
Script’ler GitHub bench/ dizininde açık kaynak.
Neden Önemli?
agentic-retrieval trendi, agent’ların token ve latency bütçesini doğrudan etkiliyor. Bulut kod indeksine karşı yerel embedding, kurumsal gizlilik gereksinimlerinde avantaj sunabilir; Türkiye’de Cursor/Claude Code kullanan geliştirici kitlesi için pratik bir iş akışı denemesi.
Teknik Detaylar
- Platform: macOS 14+, Apple Silicon uygulama; Intel/Linux için backend + browser visualizer
- Sürüm sinyali: 0.5.9 (ürün sitesi)
- Entegrasyon:
pensieve integrate recommended— MCP + “search before you grep” talimat bloğu - Opsiyonel bulut AI: özet için Qwen 3.5 9B yerleşik veya LM Studio / Claude / Codex
Bağlam
mcp ekosistemi belge, tasarım ve kod bağlamını standartlaştırıyor; Pensieve bu hattın kod arama kolu. Hacker News lansman tartışması erken kullanıcı geri bildirimini topluyor. ai-assisted-coding araçları varsayılan olarak geniş grep ve dosya okuma kullanıyor; bu pattern token maliyetini ve latency’yi artırıyor. Yerel indeks, özellikle monorepo ve çok modüllü backend projelerinde “hangi dosyada?” sorusunu tek çağrıda yanıtlamayı hedefliyor.
Ownership ve bus-factor özellikleri, sadece arama değil organizasyonel hafıza katmanı ekliyor: blame verisi hangi modülün tek kişiye bağlı olduğunu agent’a gösteriyor. Bu, code review ve incident response senaryolarında insan ekipler için de faydalı olabilir.
Gizlilik açısından embedding’lerin ~/.pensieve altında kalması, bulut tabanlı “code intelligence” ürünlerine karşı argüman sunuyor. Opsiyonel bulut özet API’leri açıkça opt-in; güvenlik politikası yazan ekipler hangi modellerin çağrıldığını denetlemeli.
Sonraki Adımlar
Linux/Intel tam uygulama desteği, bağımsız benchmark tekrarları ve kurumsal SSO/policy entegrasyonu olgunluk göstergeleri olacak. Üretim öncesi kendi depolarınızda maliyet ve doğruluk ölçümü önerilir. bench/ script’leri tekrarlanabilir; farklı model sağlayıcıları ve repo boyutlarında sonuçlar değişebilir.
Rakip yüzey: IDE içi semantic search, GitHub Copilot workspace index ve bulut RAG çözümleri benzer problemi farklı trade-off’larla çözüyor. Pensieve’nin yerel-first pozisyonu, özellikle fikri mülkiyet kısıtlı sektörlerde (bankacılık, savunma tedarik zinciri) ve offline çalışma gereksinimlerinde öne çıkıyor. Cursor kullanıcıları için MCP kurulumu düşük sürtünmeli; ekip politikası “önce Pensieve, sonra grep” kuralını agent system prompt’una yazabilir.
Operasyonel not: indeks boyutu ve güncelleme sıklığı büyük monorepo’larda disk ve CPU kullanımını artırır; CI makinelerinde indeks paylaşımı henüz ürün dokümantasyonunun odak dışı kalabileceği bir alan. Watch modu uncommitted edit’leri yeniden indekslediğinde, uzun oturumlarda tutarlılık testi yapılmalı.
Hibrit arama sözdizimi, agent’ların yanlış dosyayı okuma olasılığını düşürmeyi hedefliyor: anlamsal sorgu geniş aday kümesi getirir, in: ve ext: filtreleri kapsamı daraltır, tırnaklı ifade tam eşleşme sağlar. Bu, klasik grep + manuel dosya seçiminden daha yapılandırılmış bir retrieval politikası.
Ekip liderleri bus-factor uyarılarını sprint planlamasında kullanabilir: tek kişiye bağlı modüller review ve pairing önceliği alır. Bu özellik arama ürününde nadir görülür; Pensieve’nin “kod + organizasyon” birleşimi farklılaştırıcı iddia.
HN lansmanı erken hata raporları ve feature istekleri topluyor; üretim kritik path’te kullanmadan önce bir sprint boyunca yan görev olarak pilot önerilir. Benchmark iddiaları tekrarlanabilir script’lerle geliyor — kendi repo’nuzda aynı ölçümü koşmak, vendor rakamlarına kör güvenmekten daha sağlıklı.