Hypomnema - Claude Code के अंदर चलने वाला LLM-native personal wiki (open source)

 (github.com/sk-lim19f)
1 पॉइंट द्वारा limsangkyu 16 시간 전 | अभी कोई टिप्पणी नहीं है. | WhatsApp पर शेयर करें

Hypomnema एक LLM-native personal wiki OSS है जो Claude Code के अंदर एक slash कमांड से चलता है.
यह ~/hypomnema/ फ़ोल्डर में plain text Markdown + git के साथ रहता है, और इसमें कोई external service / API key / vector DB नहीं है.
यूज़र द्वारा दिया गया मूल स्रोत sources/ में जस का तस सुरक्षित रहता है, और Claude द्वारा synthesized नतीजे pages/ में जमा होते जाते हैं.
जब वही विषय फिर से सामने आता है, तो यह नया पेज बनाने के बजाय मौजूदा पेज को अपडेट करता है.

इसे बनाने की वजह AI के साथ रोज़ काम करते हुए जमा हुई चार समस्याएँ थीं.
(1) हर नए session में कल का context फिर से समझाने की लागत
(2) नतीजे तेज़ी से जमा होते जाते हैं, लेकिन ऐसा क्यों बनाया गया था यह कहीं दर्ज नहीं होता, इसलिए एक महीने बाद debugging और महँगी हो जाती है और technical debt बढ़ता है
(3) Notion·Obsidian·Confluence सब इस्तेमाल करके देखा, लेकिन "कोई automation नहीं / कोई synthesis नहीं / legacy बन जाना / फिर कभी न देखना" इन चार जालों में manual wiki टूट जाती है
(4) Karpathy की छोटी Gist — "RAG हर बार दोबारा पढ़ता है, लेकिन wiki एक बार synthesized ज्ञान को स्थायी बना देती है. Bottleneck हमेशा bookkeeping था, और LLM उसकी लागत को 0 तक घटा देता है" — ने जवाब सुझाया.

इसलिए मैंने दो Markdown फ़ोल्डरों से शुरुआत की और रोज़ जिन हिस्सों से झुंझलाहट होती गई, उनमें एक-एक lifecycle hook जोड़ता गया.

मुख्य सार

  • Concept: RAG(Retrieval-Augmented Generation, retrieval-augmented generation) की जगह wiki. LLM जिस पेज को एक बार synthesize कर दे, उसे सुरक्षित रखा जाता है, और अगली बार उसी पर आगे जोड़ा जाता है. Plain text Markdown + git, external service / API key / vector DB नहीं.
  • Install: npm install -g hypomnema → Claude Code में /hypo:init.
  • Single source of truth + one-way reflection: behavior correction केवल pages/feedback/<slug>.md एक ही जगह लिखी जाती है. hypomnema feedback-sync कमांड MEMORY.md (अधिकतम 200 लाइन) और <learned_behaviors> (अधिकतम 10, 5 फ़ील्ड की सख्त जाँच) में इसे अपने-आप फिर से calculate करके reflect करता है.
  • नए SCHEMA enforced fields: type: feedback पेज में 9 required fields अनिवार्य हैं. upgrade --apply backfill checklist अपने-आप लिखता है. Automatic draft(stub) को जानबूझकर reject किया गया — क्योंकि अगर गलत default values भर दी जाएँ, तो दोनों derived surfaces (MEMORY और CLAUDE.md) में चुपचाप गलत behavior बहने लगता है.
  • Extension files के साथ bundled sync: wiki के अंदर extensions/{agents,commands,hooks,skills} directories साथ रखी जाती हैं और ~/.claude/ में अपने-आप mirror होती हैं. --codex flag देने पर ~/.codex/ में केवल hooks + commands subset (core hooks सहित) mirror होता है.
  • Automation reinforcement: अगर current working directory(cwd) में wiki project नहीं है, तो auto-create suggestion; meaningful session खत्म होने पर हल्का wrap-up (minimal crystallize) auto-suggestion; WebFetch / WebSearch के तुरंत बाद /hypo:ingest suggestion; update notifications के 2 चैनल (npm / plugin); W8 lint warning से पुराने design-history.md का पता; दूसरे project में लीक हो रहे corrections को रोकना (scope: project:* exact match enforcement); code comments cleanup phase 1 (समय बीतने पर अर्थ धुँधला कर देने वाले time-bound references हटाना, design anchors को बचाए रखना).

मौजूदा LLM Wiki OSS से अंतर

Karpathy Gist से निकले projects कम समय में 10 से ज़्यादा आ चुके हैं.
अलग-अलग क्षेत्रों के हिसाब से सीधे देखने पर अंतर इस तरह हैं.

  • वे क्षेत्र जिन्हें Hypomnema मुख्य रूप से संभालता है: session lifecycle automation (14 hooks के साथ SessionStart / PreCompact / Stop आदि में wiki संचालन को बाँधना), AI behavior correction का single source of truth + automatic one-way reflection, ~/.claude/{commands,agents,skills,hooks} auto-mirroring.
  • nvk/llm-wiki: --mode thesis के साथ proposition support/opposition agents को parallel चलाने वाला validation mode इसकी मज़बूती है.
  • SamurAIGPT/llm-wiki-agent: PDF / Word / PPT / Excel multi-format ingest इसकी मज़बूती है.
  • nashsu/llm_wiki: Electron desktop GUI (6.6k stars) सबसे mature है.

Hypomnema ने thesis mode · multi-format ingest · अपनी GUI जानबूझकर नहीं बनाई — उन क्षेत्रों में ऊपर के projects बेहतर हैं, और ज़रूरत हो तो Obsidian जैसे मौजूदा tools साथ में इस्तेमाल किए जा सकते हैं.
संक्षेप में, Claude Code users के रोज़मर्रा workflow के अंदर wiki को खींच लाने वाला हिस्सा Hypomnema की सबसे मजबूत क्षमता है.

घटक

8 slash commands(/hypo:ingest, /hypo:query, /hypo:crystallize, /hypo:resume, /hypo:feedback, /hypo:verify, /hypo:lint, /hypo:graph) + 5 CLI subcommands(init, upgrade [--apply] [--codex], doctor [extensions], uninstall, feedback-sync) + 14 lifecycle hooks + Claude Agent Skills compatibility.
हर command और hook का विस्तृत behavior README और dev.to के English walkthrough में संकलित है.

जानबूझकर छोड़ी गई चीज़ें

vector DB · API key · GUI · mode matrix · SCHEMA auto stub नहीं — इन सबको "गलत default values चुपचाप गलत behavior में बदल जाती हैं" या "यह काम दूसरे tools पहले से बेहतर करते हैं" इस वजह से जानबूझकर बाहर रखा गया है.

requirements + links

contribution guide

Feedback·issues·PR का स्वागत है.

संबंधित पढ़ाई

अभी कोई टिप्पणी नहीं है.

अभी कोई टिप्पणी नहीं है.