Hypomnema - wiki pribadi native-LLM yang berjalan di dalam Claude Code (open source)

 (github.com/sk-lim19f)
1 poin oleh limsangkyu 16 jam lalu | Belum ada komentar. | Bagikan ke WhatsApp

Hypomnema adalah OSS wiki pribadi native-LLM yang berjalan di dalam Claude Code hanya dengan satu slash.
Ia hidup di folder ~/hypomnema/ dengan markdown teks biasa + git, tanpa layanan eksternal / API key / vector DB.
Sumber asli yang diberikan pengguna disimpan apa adanya di sources/, dan hasil sintesis Claude akan terus diakumulasikan di pages/.
Saat menemui topik yang sama lagi, ia tidak membuat halaman baru, melainkan memperbarui halaman yang sudah ada.

Alasan membuatnya berawal dari empat masalah yang menumpuk saat bekerja dengan AI setiap hari.
(1) Biaya untuk menjelaskan ulang konteks kemarin di setiap sesi baru
(2) Hasil menumpuk dengan cepat, tetapi mengapa ditulis seperti itu tidak ada di mana pun, sehingga utang teknis membuat debugging sebulan kemudian jadi lebih mahal
(3) Sudah mencoba Notion, Obsidian, dan Confluence, tetapi wiki manual runtuh dalam empat jebakan: "tanpa otomasi / tanpa sintesis / menjadi legacy / tidak dibuka lagi"
(4) Gist singkat Karpathy — "RAG membaca ulang setiap kali, tetapi wiki membuat pengetahuan yang sudah disintesis sekali menjadi permanen. Hambatannya selalu bookkeeping, dan LLM menurunkan biaya itu menjadi 0" — menunjukkan jawabannya.

Karena itu, semuanya dimulai dari dua folder markdown, lalu setiap kali muncul bagian yang mengganggu dalam penggunaan sehari-hari, satu per satu lifecycle hook ditambahkan.

Ringkasan inti

  • Konsep: wiki alih-alih RAG (Retrieval-Augmented Generation). Halaman yang sudah disintesis sekali oleh LLM dipertahankan, lalu pada kesempatan berikutnya ditumpuk lagi di atasnya. Markdown teks biasa + git, tanpa layanan eksternal / API key / vector DB.
  • Instalasi: npm install -g hypomnema → di Claude Code jalankan /hypo:init.
  • Satu sumber kebenaran + refleksi satu arah: koreksi perilaku dicatat hanya di satu tempat, yaitu pages/feedback/<slug>.md. Perintah hypomnema feedback-sync akan menghitung ulang dan menerapkannya secara otomatis ke MEMORY.md (batas 200 baris) dan <learned_behaviors> (batas 10 item, validasi ketat 5 field).
  • Field wajib pada SCHEMA baru: untuk halaman type: feedback, 9 field wajib diberlakukan. upgrade --apply secara otomatis membuat checklist backfill. Draft otomatis (stub) sengaja ditolak — karena jika nilai default yang salah ditanamkan, perilaku yang salah bisa mengalir diam-diam ke dua turunan (MEMORY dan CLAUDE.md).
  • Sinkronisasi bundel file ekstensi: direktori extensions/{agents,commands,hooks,skills} disimpan bersama di dalam wiki dan otomatis dicerminkan ke ~/.claude/. Jika diberi flag --codex, hanya subset hooks + commands (termasuk hook inti) yang dicerminkan ke ~/.codex/.
  • Penguatan otomasi: jika tidak ada proyek wiki di current working directory (cwd), sistem otomatis menyarankan pembuatan; saat sesi bermakna selesai, sistem otomatis menyarankan penutupan ringan (minimal crystallize); setelah WebFetch / WebSearch, sistem memberi panduan untuk menyarankan /hypo:ingest; notifikasi pembaruan tersedia di 2 kanal (npm / plugin); peringatan lint W8 menemukan design-history.md yang usang; koreksi yang bocor ke proyek lain diblokir (memaksa exact match scope: project:*); tahap 1 pembersihan komentar kode (menghapus referensi yang terikat waktu dan maknanya memudar seiring waktu, sambil mempertahankan anchor desain).

Perbedaan dengan OSS LLM Wiki yang sudah ada

Dalam waktu singkat, lebih dari 10 proyek turunan dari Gist Karpathy telah muncul.
Berikut rangkuman perbedaan per area berdasarkan peninjauan langsung.

  • Area utama yang menjadi fokus Hypomnema: otomasi lifecycle sesi (mengikat operasi wiki ke SessionStart / PreCompact / Stop dan lainnya lewat 14 hook), menjadikan koreksi perilaku AI sebagai satu sumber kebenaran + refleksi satu arah otomatis, serta auto-mirroring ~/.claude/{commands,agents,skills,hooks}.
  • nvk/llm-wiki: kuat pada mode verifikasi yang menjalankan agen pro-kontra secara paralel dengan --mode thesis.
  • SamurAIGPT/llm-wiki-agent: kuat pada ingest multi-format PDF / Word / PPT / Excel.
  • nashsu/llm_wiki: GUI desktop Electron (6.6k stars) yang paling matang.

Hypomnema sengaja tidak membuat mode thesis, ingest multi-format, atau GUI sendiri — area itu lebih baik ditangani oleh proyek-proyek di atas, dan bila perlu dapat digunakan bersama alat yang sudah ada seperti Obsidian.
Singkatnya, area terkuat Hypomnema adalah menarik wiki masuk ke alur kerja harian yang benar-benar dipakai pengguna Claude Code.

Komponen

8 slash command (/hypo:ingest, /hypo:query, /hypo:crystallize, /hypo:resume, /hypo:feedback, /hypo:verify, /hypo:lint, /hypo:graph) + 5 CLI subcommand (init, upgrade [--apply] [--codex], doctor [extensions], uninstall, feedback-sync) + 14 lifecycle hook + kompatibilitas dengan Claude Agent Skills.
Detail perilaku tiap perintah dan hook telah dirangkum di README dan walkthrough berbahasa Inggris di dev.to.

Hal-hal yang sengaja tidak disertakan

Tanpa vector DB, API key, GUI, mode matrix, maupun stub otomatis untuk SCHEMA — semuanya sengaja dikecualikan dengan alasan "nilai default yang salah akan diam-diam mengalir menjadi perilaku yang salah" atau "sudah ada alat lain yang melakukannya dengan baik".

Persyaratan + tautan

Panduan kontribusi

Masukan, issue, dan PR sangat diterima.

Bacaan terkait

Belum ada komentar.

Belum ada komentar.