🌐 Bu otomatik bir çevirisidir. Topluluk düzeltmeleri memnuniyetle karşılanır!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
Claude Code için geliştirilmiş kalıcı bellek sıkıştırma sistemi.
Hızlı Başlangıç • Nasıl Çalışır • Arama Araçları • Dokümantasyon • Yapılandırma • Sorun Giderme • Lisans
Claude-Mem, araç kullanım gözlemlerini otomatik olarak yakalayarak, anlamsal özetler oluşturarak ve bunları gelecekteki oturumlarda kullanılabilir hale getirerek bağlamı oturumlar arası sorunsuzca korur. Bu, Claude'un oturumlar sona erse veya yeniden bağlansa bile projeler hakkındaki bilgi sürekliliğini korumasını sağlar.
Terminal üzerinden yeni bir Claude Code oturumu başlatın ve aşağıdaki komutları girin:
> /plugin marketplace add thedotmack/claude-mem > /plugin install claude-mem
Claude Code'u yeniden başlatın. Önceki oturumlardaki bağlam otomatik olarak yeni oturumlarda görünecektir.
Temel Özellikler:
- 🧠 Kalıcı Bellek - Bağlam oturumlar arası hayatta kalır
- 📊 Aşamalı Açıklama - Token maliyeti görünürlüğü ile katmanlı bellek erişimi
- 🔍 Beceri Tabanlı Arama - mem-search becerisi ile proje geçmişinizi sorgulayın
- 🖥️ Web Görüntüleyici Arayüzü - http://localhost:37777 adresinde gerçek zamanlı bellek akışı
- 💻 Claude Desktop Becerisi - Claude Desktop konuşmalarından bellek araması yapın
- 🔒 Gizlilik Kontrolü - Hassas içeriği depolamadan hariç tutmak için
<private>etiketlerini kullanın - ⚙️ Bağlam Yapılandırması - Hangi bağlamın enjekte edileceği üzerinde detaylı kontrol
- 🤖 Otomatik Çalışma - Manuel müdahale gerektirmez
- 🔗 Alıntılar - ID'lerle geçmiş gözlemlere referans verin (http://localhost:37777/api/observation/{id} üzerinden erişin veya http://localhost:37777 adresindeki web görüntüleyicide tümünü görüntüleyin)
- 🧪 Beta Kanalı - Sürüm değiştirme yoluyla Endless Mode gibi deneysel özellikleri deneyin
📚 Tam Dokümantasyonu Görüntüle - Resmi web sitesinde göz atın
- Kurulum Kılavuzu - Hızlı başlangıç ve gelişmiş kurulum
- Kullanım Kılavuzu - Claude-Mem otomatik olarak nasıl çalışır
- Arama Araçları - Doğal dil ile proje geçmişinizi sorgulayın
- Beta Özellikleri - Endless Mode gibi deneysel özellikleri deneyin
- Bağlam Mühendisliği - AI ajan bağlam optimizasyon ilkeleri
- Aşamalı Açıklama - Claude-Mem'in bağlam hazırlama stratejisinin ardındaki felsefe
- Genel Bakış - Sistem bileşenleri ve veri akışı
- Mimari Evrimi - v3'ten v5'e yolculuk
- Hooks Mimarisi - Claude-Mem yaşam döngüsü hook'larını nasıl kullanır
- Hooks Referansı - 7 hook betiği açıklandı
- Worker Servisi - HTTP API ve Bun yönetimi
- Veritabanı - SQLite şeması ve FTS5 arama
- Arama Mimarisi - Chroma vektör veritabanı ile hibrit arama
- Yapılandırma - Ortam değişkenleri ve ayarlar
- Geliştirme - Derleme, test etme, katkıda bulunma
- Sorun Giderme - Yaygın sorunlar ve çözümler
Temel Bileşenler:
- 5 Yaşam Döngüsü Hook'u - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook betiği)
- Akıllı Kurulum - Önbelleğe alınmış bağımlılık kontrolcüsü (ön-hook betiği, yaşam döngüsü hook'u değil)
- Worker Servisi - Web görüntüleyici arayüzü ve 10 arama uç noktası ile 37777 portunda HTTP API, Bun tarafından yönetilir
- SQLite Veritabanı - Oturumları, gözlemleri, özetleri saklar
- mem-search Becerisi - Aşamalı açıklama ile doğal dil sorguları
- Chroma Vektör Veritabanı - Akıllı bağlam erişimi için hibrit anlamsal + anahtar kelime arama
Detaylar için Mimari Genel Bakış bölümüne bakın.
Claude-Mem, geçmiş çalışmalarınız hakkında sorduğunuzda otomatik olarak devreye giren mem-search becerisi aracılığıyla akıllı arama sağlar:
Nasıl Çalışır:
- Sadece doğal bir şekilde sorun: "Geçen oturumda ne yaptık?" veya "Bu hatayı daha önce düzelttik mi?"
- Claude, ilgili bağlamı bulmak için otomatik olarak mem-search becerisini çağırır
Mevcut Arama İşlemleri:
- Search Observations - Gözlemler arasında tam metin arama
- Search Sessions - Oturum özetleri arasında tam metin arama
- Search Prompts - Ham kullanıcı isteklerinde arama
- By Concept - Kavram etiketlerine göre bul (discovery, problem-solution, pattern, vb.)
- By File - Belirli dosyalara referans veren gözlemleri bul
- By Type - Türe göre bul (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - Bir proje için yakın zamanlı oturum bağlamını al
- Timeline - Belirli bir zaman noktası etrafındaki birleşik bağlam zaman çizelgesini al
- Timeline by Query - Gözlemleri ara ve en iyi eşleşme etrafındaki zaman çizelgesi bağlamını al
- API Help - Arama API dokümantasyonunu al
Örnek Doğal Dil Sorguları:
"Geçen oturumda hangi hataları düzelttik?" "Kimlik doğrulamayı nasıl uyguladık?" "worker-service.ts dosyasında hangi değişiklikler yapıldı?" "Bu projedeki son çalışmaları göster" "Görüntüleyici arayüzünü eklediğimizde ne oluyordu?"
Detaylı örnekler için Arama Araçları Kılavuzu bölümüne bakın.
Claude-Mem, Endless Mode (genişletilmiş oturumlar için biyomimetik bellek mimarisi) gibi deneysel özellikler içeren bir beta kanalı sunar. http://localhost:37777 → Settings adresindeki web görüntüleyici arayüzünden kararlı ve beta sürümleri arasında geçiş yapın.
Endless Mode hakkında detaylar ve nasıl deneyeceğiniz için Beta Özellikleri Dokümantasyonu bölümüne bakın.
- Node.js: 18.0.0 veya üzeri
- Claude Code: Plugin desteği olan en son sürüm
- Bun: JavaScript çalışma zamanı ve işlem yöneticisi (eksikse otomatik kurulur)
- uv: Vektör arama için Python paket yöneticisi (eksikse otomatik kurulur)
- SQLite 3: Kalıcı depolama için (dahildir)
Ayarlar ~/.claude-mem/settings.json dosyasında yönetilir (ilk çalıştırmada varsayılanlarla otomatik oluşturulur). AI modelini, worker portunu, veri dizinini, log seviyesini ve bağlam enjeksiyon ayarlarını yapılandırın.
Tüm mevcut ayarlar ve örnekler için Yapılandırma Kılavuzu bölümüne bakın.
Derleme talimatları, test etme ve katkı iş akışı için Geliştirme Kılavuzu bölümüne bakın.
Sorunlarla karşılaşırsanız, sorunu Claude'a açıklayın ve troubleshoot becerisi otomatik olarak teşhis edip düzeltmeleri sağlayacaktır.
Yaygın sorunlar ve çözümler için Sorun Giderme Kılavuzu bölümüne bakın.
Otomatik oluşturucu ile kapsamlı hata raporları oluşturun:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
Katkılar memnuniyetle karşılanır! Lütfen:
- Depoyu fork edin
- Bir özellik dalı oluşturun
- Testlerle değişikliklerinizi yapın
- Dokümantasyonu güncelleyin
- Pull Request gönderin
Katkı iş akışı için Geliştirme Kılavuzu bölümüne bakın.
Bu proje GNU Affero General Public License v3.0 (AGPL-3.0) altında lisanslanmıştır.
Telif Hakkı (C) 2025 Alex Newman (@thedotmack). Tüm hakları saklıdır.
Tam detaylar için LICENSE dosyasına bakın.
Bu Ne Anlama Gelir:
- Bu yazılımı özgürce kullanabilir, değiştirebilir ve dağıtabilirsiniz
- Değiştirip bir ağ sunucusunda dağıtırsanız, kaynak kodunuzu kullanılabilir hale getirmelisiniz
- Türev çalışmalar da AGPL-3.0 altında lisanslanmalıdır
- Bu yazılım için HİÇBİR GARANTİ yoktur
Ragtime Hakkında Not: ragtime/ dizini ayrı olarak PolyForm Noncommercial License 1.0.0 altında lisanslanmıştır. Detaylar için ragtime/LICENSE dosyasına bakın.
- Dokümantasyon: docs/
- Sorunlar: GitHub Issues
- Depo: github.com/thedotmack/claude-mem
- Yazar: Alex Newman (@thedotmack)
Claude Agent SDK ile geliştirilmiştir | Claude Code ile desteklenmektedir | TypeScript ile yapılmıştır
