CTX: Claude Code oturumları arasında bellek — `pip install` veya `/plugin install` ile kurulum

Claude Code, oturum kapandığında tüm bağlamı kaybeder. CTX bu sorunu Claude Code hook'larıyla çözüyor.

Nasıl çalışır: UserPromptSubmit olayında 1 ms içinde 3 tür bağlamı otomatik olarak enjekte eder.

• G1: git log tabanlı karar alma zaman çizelgesi (dün bu kararı neden verdiğinizi)
• G2: BM25 kod/doküman araması (ilgili dosyaları otomatik enjekte eder)
• CM: geçmiş konuşma kasası (SQLite FTS5 + isteğe bağlı vektör)

Ölçülen değerler:

• Bellek geri çağırma doğruluğu: 0.880 [0.762, 0.944] (MAB N=50, Wilson CI)
• Temel seviye (yok): 0.00
• Gerçek 10.000+ tur bazında kullanım oranı: %39,6

LLM çağrısı yok. Bulut yok. Tamamen yerel.

Kurulum:
pip install ctx-retriever && ctx-install
veya Claude Code içinde: /plugin install ctx@jaytoone

[zihado]

/plugin ile kurunca şöyle görünüyor
⎿ Marketplace "jaytoone" bulunamadı

[kurthong]

İlginç yaklaşımı keyifle inceledim. Trigger sınıflandırmasıyla routing yapma fikri bence çok iyi bir fikir.

Merak ettiğim bir nokta var: BM25 katmanının tokenizer’ı README’de belirtilmemiş gibi görünüyor; Korece işleme tarafını nasıl ele almayı düşünüyorsunuz? Varsayılan boşluk tokenizer’ı kullanılıyorsa, "geomsaekhada"/"geomsaekhaneun" ayrı token’lara dönüşeceği için Korece yorum ve docstring aramalarında recall ciddi biçimde düşecektir.
multilingual-e5-small fallback’i var ama BM25 katmanının kendi Korece (CJK dahil) işleme planını merak ediyorum. (Ben de seCall adlı bir llm wiki uygulaması geliştirirken CJK aramasında sorun yaşadım ve bunu Lindera ko-dic + Kiwi-rs ekleyerek çözdüm; CTX ise trigger routing
yapısına sahip olduğundan farklı bir yaklaşım mümkün olabilir diye düşündüm.)

[nave94]

Tam olarak doğru noktaya değindiniz. Mevcut BM25 katmanındaki tokenize() işlevi, boşluk+noktalama ayrımından sonra Hangul/CJK karakterlerini ayrıca tek tek karakter düzeyinde parçalar. '검색하다' → ['검','색','하','다'] + '검색하다' tam belirteci biçimindedir. Kısmi eşleşme oluyor ama biçimbirimsel anlam birimlerinin ezildiği de doğru.

Kiwi/Lindera entegrasyonunu bir sonraki aşama adayı olarak görüyoruz. CTX, sorgu trigger yönlendirmesinden önce dil algılama yaptığı için, Korece algılama → biçimbirim çözümleyici dalı nispeten temiz bir şekilde eklenebilir gibi görünüyor.

Bunu seCall'da Lindera ko-dic + Kiwi-rs kombinasyonuyla çözdüğünüzü duymak ilginç. Acaba CJK karışık metni (Korece + İngilizce kod yorumları) nasıl ele aldığınızı paylaşabilir misiniz?

[nave94]

v0.3.19 güncellemesi — oturum kapanırken otomatik gönderim:

En büyük değişiklik: artık ctx-install sonrasında hiçbir komut vermeden sadece normal kullanım yapsanız bile, oturum kapandığında istatistikler otomatik olarak Turso'ya gönderiliyor.

Şema v1.7 ek alanları:

• project_type_id: teknoloji yığını parmak izi (python_ml/nextjs_react vb.) — kullanıcılar arası iyileştirmenin anahtarı
• ctx_version: sürüm bazlı iyileştirmeleri izleme
• utility_by_qtype: KEYWORD %16'ya karşı SEMANTIC %42 farkını oturum düzeyinde ölçme

Vazgeçme: ~/.claude/ctx-telemetry-revoke dosyası oluşturulursa gönderim durur

[nave94]

v0.3.16 güncellemesi ve canlı demo eklendi:

Canlı dashboard (HF Space): https://be2jay-ctx-dashboard-demo.hf.space

• gerçek zamanlı oturum istatistikleri, utility_rate grafiği, bilgi grafiği görselleştirmesi

Başlıca değişiklikler (v0.3.16):

• durum: Alpha → Beta
• Stage 2 yükleme pipeline'ı etkinleştirildi (k-anonimlikli session_aggregate yüklemesi)
• ctx-install çalıştırıldığında opt-in bilgilendirmesi gösterimi eklendi
• BM25 CJK tokenizer açıklaması eklendi (README'ye yansıtılacak)

Kullanım oranı ölçümü (n=1054 oturum):

• genel ortalama utility_rate: %39,6
• CM bloğu: %52,6 (en yüksek)
• SEMANTIC sorgu: %42,0 vs KEYWORD: %16,0 (%42 puan fark)

[nave94]

Güncelleme duyurusu (v0.3.13):

Kurulum yöntemi önceliği:

[Önerilen] Claude Code eklentisi (1. adım):
/plugin install ctx@jaytoone

[Alternatif] pip:
pip install ctx-retriever && ctx-install

v0.3.13 değişiklikleri: vec-daemon için izole venv (numpy/ABI çakışmalarını önlemek için), BGE reranker isteğe bağlı (CTX_BGE_ENABLE=1)

[nave94]

Dashboard çalışma videosu (39 saniye): https://drive.google.com/file/d/…

Ayrıntılı içerik: https://dev.to/jaewon_jang_d63fddcf69ac2/…

[nave94]

v0.3.28 güncellemesi (2026-05-20): GitHub’da 6 ⭐’ya ulaştı, PyPI’de aylık 2.726 indirme. Bu sürümde gizlilik şeffaflığı güçlendirildi — PRIVACY.md eklendi (hash’in geriye dönük izlenemediğinin kanıtı, GDPR/CCPA/PIPA dayanakları), ilk çalıştırmada tek seferlik telemetri bildirimi, ctx-telemetry disable/enable komutları eklendi. Eski sürüm (v0.3.25 ve altı) kullanıcılarına pip install --upgrade ctx-retriever önerilir.

[nave94]

v0.3.27 güncellemesi: Artık Claude Code kancaları tek satırlık pip install ctx-retriever ile otomatik olarak bağlanıyor (ctx-install komutunu ayrıca çalıştırmak gerekmiyor). Arka planda, site-packages içindeki .pth dosyası ilk Python çalıştırmasında kancaları otomatik kuruyor; ayrıca SessionStart kancası ve yeniden deneme kuyruğu eklendi, böylece veri toplama kararlılığı yaklaşık %70’ten %93’e yükseldi. PyPI üzerinden doğrudan v0.3.27 kurulabiliyor.