Claude Code konuşma kayıtlarını otomatik olarak Obsidian bilgi grafiğine bağlayan araç

 (namyunwoo.github.io)
4 puan yazan namyunwoo 2026-03-13 | 1 yorum | WhatsApp'ta paylaş

Merhaba. Son dönemde terminal ortamında AI kodlama asistanı Claude Code kullanırken yaşadığım sıkıntıyı çözmek için geliştirdiğim açık kaynak proje claude-knowledge-graphı tanıtmak istiyorum.

Geliştirme motivasyonu (My Pain Point)

Veri bilimi alanında çalışırken birden fazla ekipten gelen veri analizi ve geliştirme taleplerini aynı anda yürütüyorum. Yakın zamanda Claude Code’u kullanmaya başladıktan sonra verimliliğim ciddi biçimde arttı, ancak kritik bir sorun vardı.

  • Uçucu bilgi ve parçalanma: Her yeni analiz talebinde yeni bir ad-hoc klasör açıp çalışıyorum; ancak oturum kapandığında, AI ile uğraşırken verdiğim mimari kararlar, karmaşık ön işleme kodları ve debug süreci olduğu gibi kayboluyor.
  • Verimsiz tekrarlar: Daha sonra benzer bir iş geldiğinde geçmişi bulamadığım için AI’a durumu en baştan yeniden anlatmak ya da hafızamı zorlayarak kodu tekrar yazmak zorunda kalıyor, sık sık zaman kaybediyordum.

“Daha önce hangi klasörde çözdüğüm bir problem olduğunu düşünmek zorunda kalmadan, AI geçmiş çalışma kayıtlarımı mevcut bağlama uygun şekilde kendiliğinden geri getiremez mi?” sorusuyla bu projeye başladım.

Proje tanıtımı: claude-knowledge-graph

Claude Code’daki tüm konuşmaları (promptlar ve yanıtlar) yakalayıp yerel bir LLM ile analiz eden ve bunları birleşik bir Obsidian bilgi grafiği (Knowledge Graph) olarak otomatik kuran bir araçtır.

  1. Zero-Friction (tam otomasyon): Claude Code’un Hook özelliğini kullanarak arka planda çalışır. Kullanıcının her zamanki gibi sadece kod yazması yeterlidir.
  2. Yerel LLM ile güvenli etiketleme: İş tamamlandığında arka planda hafif bir yerel LLM (Qwen 3.5 4B + llama.cpp) kısa süreliğine çalışır, konuşmayı özetler, temel kavramları ve etiketleri çıkarır, ardından kapanır. Şirket içi kodun dışarı sızması konusunda endişe etmenize gerek kalmaz.
  3. Benzerlik tabanlı otomatik bağlantı (Killer Feature): Çıkarılan kavramlar, etiketler ve çalışılan dizin yolu (cwd) temel alınarak geçmiş kayıtlar ile mevcut konuşma çok boyutlu biçimde karşılaştırılır. İlişkisi yüksek geçmiş çözümleri bulup mevcut notun altına wiki bağlantısı ([[ ]]) olarak otomatik ekler.

Özellikle şu geliştiriciler için faydalı

  • Sık sık context switching yapanlar: Birden fazla proje veya ad-hoc klasör arasında gidip gelseniz bile tüm bilgi tek bir Obsidian Vault içinde toplanır ve kendiliğinden birbirine bağlanır.
  • Sıkı güvenlik koşullarında çalışanlar: Kurumsal ortamlarda hassas kod veya veriyle çalıştığı için bulut tabanlı not/log servislerini kullanmak istemeyenler için güvenli bir yerel alternatif sunar.
  • Second Brain yaklaşımını benimseyenler: Sadece düz metin logları değil, düğümler ve kenarlarla bağlı görsel bir bilgi grafiği kurmak isteyen Obsidian kullanıcılarına özellikle önerilir.

Mac (Apple Silicon) ve Linux ortamlarında iyi çalışacak şekilde tasarlanmıştır. Arka planda yerel LLM çalıştırmak için en az 16 GB RAM önerilir.

Daha ayrıntılı mimari ve kurulum yöntemi GitHub deposunda yer alıyor. Geri bildirimler ve PR’lar her zaman memnuniyetle karşılanır!

İlgili okumalar

1 yorum