Hypomnema - Claude Code içinde çalışan LLM-native kişisel wiki (açık kaynak)

 (github.com/sk-lim19f)
1 puan yazan limsangkyu 15 시간 전 | Henüz yorum yok. | WhatsApp'ta paylaş

Hypomnema, Claude Code içinde tek bir slash komutuyla çalışan LLM-native kişisel wiki OSS’sidir.
~/hypomnema/ klasöründe düz metin Markdown + git ile yaşar; harici servis / API anahtarı / vektör DB yoktur.
Kullanıcının attığı özgün kaynaklar sources/ içinde olduğu gibi korunur, Claude’un sentezlediği sonuçlar ise pages/ içinde birikir.
Aynı konuyla tekrar karşılaşınca yeni bir sayfa oluşturmak yerine mevcut sayfayı günceller.

Bunu yapma nedeni, yapay zeka ile her gün çalışırken biriken dört sorundu.
(1) Her yeni oturumda dünkü bağlamı yeniden açıklamanın maliyeti
(2) Sonuçlar hızla birikirken neden öyle yazıldığına dair hiçbir şeyin hiçbir yerde olmaması yüzünden bir ay sonra debug etmenin daha pahalı hale gelmesiyle oluşan teknik borç
(3) Notion·Obsidian·Confluence’in hepsini denemiş olmasına rağmen "otomasyon yok / sentez yok / legacy hale gelme / kimsenin bakmaması" şeklindeki dört tuzakta çöken manuel wiki’ler
(4) Karpathy’nin kısa Gist’i — "RAG her seferinde yeniden okur ama wiki, bir kez sentezlenen bilgiyi kalıcılaştırır. Darboğaz her zaman bookkeeping’ti ve LLM bunun maliyetini 0’a indirir" — bir yanıt sundu.

Bu yüzden iki Markdown klasörüyle başlayıp her gün can sıkan bir nokta çıktıkça yaşam döngüsü hook’larını teker teker ekledi.

Temel özet

  • Konsept: RAG (Retrieval-Augmented Generation) yerine wiki. LLM’in bir kez sentezlediği sayfalar korunur ve bir sonraki sefer bunların üstüne yeniden ekleme yapılır. Düz metin Markdown + git, harici servis / API anahtarı / vektör DB yok.
  • Kurulum: npm install -g hypomnema → Claude Code içinde /hypo:init.
  • Tek kaynak + tek yönlü yansıtma: Davranış düzeltmeleri yalnızca pages/feedback/<slug>.md içinde tutulur. hypomnema feedback-sync komutu bunu otomatik olarak yeniden hesaplayıp MEMORY.md’ye (üst sınır 200 satır) ve <learned_behaviors> bölümüne (üst sınır 10 öğe, 5 alan için sıkı doğrulama) yansıtır.
  • Yeni SCHEMA zorunlu alanları: type: feedback sayfalarında 9 zorunlu alan dayatılır. upgrade --apply, backfill kontrol listesini otomatik oluşturur. Otomatik taslak (stub) özellikle reddedildi — çünkü yanlış varsayılanlar yerleştirilirse bunlar iki türetilmiş yüzeye (MEMORY ve CLAUDE.md) sessizce yanlış davranış olarak yayılır.
  • Genişletme dosyalarıyla birlikte senkronizasyon: Wiki içinde extensions/{agents,commands,hooks,skills} dizinleri tutulur ve ~/.claude/ içine otomatik aynalanır. --codex bayrağı verilirse ~/.codex/ içine yalnızca hooks + commands alt kümesi (çekirdek hook’lar dahil) aynalanır.
  • Güçlendirilmiş otomasyon: Geçerli çalışma dizininde (cwd) wiki projesi yoksa otomatik oluşturma önerisi, anlamlı oturum bitimlerinde hafif kapanış (minimal crystallize) önerisinin otomatik sunulması, WebFetch / WebSearch hemen ardından /hypo:ingest önerisi, 2 kanallı güncelleme bildirimi (npm / plugin), W8 lint uyarısıyla eski design-history.md tespiti, başka projelere sızan düzeltmelerin engellenmesi (scope: project:* için tam eşleşme zorunluluğu), kod yorum temizliğinin 1. aşaması (zaman geçince anlamı bulanıklaşan zaman-bağlı referansların kaldırılması, tasarım anchor’larının korunması).

Mevcut LLM Wiki OSS’lerden farkı

Karpathy Gist’inden türeyen 10’dan fazla proje kısa sürede ortaya çıktı.
Bizzat incelenen alan bazlı farklar şöyle özetleniyor.

  • Hypomnema’nın ana odak alanı: Oturum yaşam döngüsü otomasyonu (14 hook ile SessionStart / PreCompact / Stop vb. aşamalarda wiki operasyonlarının bağlanması), yapay zeka davranış düzeltmeleri için tek kaynak + otomatik tek yönlü yansıtma, ~/.claude/{commands,agents,skills,hooks} için otomatik aynalama.
  • nvk/llm-wiki: --mode thesis ile önermenin lehine ve aleyhine ajanları paralel çalıştıran doğrulama modunda güçlü.
  • SamurAIGPT/llm-wiki-agent: PDF / Word / PPT / Excel çoklu format ingest tarafında güçlü.
  • nashsu/llm_wiki: Electron masaüstü GUI’si (6.6k stars) en olgun seçenek.

Hypomnema, thesis modu · çoklu format ingest · kendi GUI’sini bilinçli olarak üretmedi — bu alanlarda yukarıdaki projeler daha iyi iş çıkarıyor ve gerekirse Obsidian gibi mevcut araçlarla birlikte kullanılıyor.
Özetle wiki’yi Claude Code kullanıcılarının her gün kullandığı iş akışının içine çekme kısmı, Hypomnema’nın en güçlü olduğu alan.

Bileşenler

8 slash komutu (/hypo:ingest, /hypo:query, /hypo:crystallize, /hypo:resume, /hypo:feedback, /hypo:verify, /hypo:lint, /hypo:graph) + 5 CLI alt komutu (init, upgrade [--apply] [--codex], doctor [extensions], uninstall, feedback-sync) + 14 yaşam döngüsü hook’u + Claude Agent Skills uyumluluğu.
Her komut ve hook’un ayrıntılı davranışı README ile dev.to’daki İngilizce walkthrough’da derlenmiştir.

Bilinçli olarak dışarıda bırakılanlar

Vektör DB · API anahtarı · GUI · mod matrisi · SCHEMA otomatik stub yok — bunların hepsi "yanlış varsayılanların sessizce yanlış davranışa akması" veya "bunu zaten başka bir araç daha iyi yapıyor" gerekçesiyle bilinçli olarak hariç tutuldu.

Gereksinimler + bağlantılar

Katkı rehberi

Geri bildirim, issue ve PR’lar memnuniyetle karşılanır.

İlgili okumalar

Henüz yorum yok.

Henüz yorum yok.