Hypomnema – LLM-native persönliches Wiki innerhalb von Claude Code (Open Source)

Hypomnema ist ein LLM-native Personal-Wiki-OSS, das innerhalb von Claude Code mit einem einzigen Slash läuft.
Es lebt im Ordner ~/hypomnema/ als Plain-Text-Markdown + git und benötigt weder externe Dienste, API-Keys noch eine Vector DB.
Vom Nutzer eingeworfene Originalquellen bleiben unverändert in sources/ erhalten, und von Claude synthetisierte Ergebnisse werden in pages/ fortlaufend angesammelt.
Wenn dasselbe Thema erneut auftaucht, wird keine neue Seite erzeugt, sondern die bestehende Seite aktualisiert.

Der Grund für die Entwicklung waren vier Probleme, die sich aus der täglichen Arbeit mit AI ergeben haben.
(1) Die Kosten, in jeder neuen Session den Kontext von gestern erneut zu erklären
(2) Ergebnisse stapeln sich schnell, aber warum etwas so implementiert wurde steht nirgends, wodurch Debugging einen Monat später als technische Schuld teurer wird
(3) Ich habe Notion, Obsidian und Confluence alle ausprobiert, aber manuelle Wikis scheitern an den vier Fallen „keine Automatisierung / keine Synthese / Legacy-Werdung / wird nicht gelesen“
(4) Karpathys kurzes Gist — „RAG liest jedes Mal neu, aber ein Wiki macht einmal synthetisiertes Wissen dauerhaft. Der Flaschenhals war immer Bookkeeping, und LLMs senken diese Kosten auf 0“ — gab die Antwort vor.

Also habe ich mit zwei Markdown-Ordnern begonnen und jedes Mal, wenn im Alltag etwas lästig wurde, einen Lifecycle-Hook ergänzt.

Kernzusammenfassung

• Konzept: Wiki statt RAG (Retrieval-Augmented Generation). Seiten, die das LLM einmal synthetisiert hat, werden erhalten und beim nächsten Mal weiter ausgebaut. Plain-Text-Markdown + git, keine externen Dienste, API-Keys oder Vector DB.
• Installation: npm install -g hypomnema → in Claude Code /hypo:init.
• Single Source of Truth + unidirektionale Übernahme: Verhaltenskorrekturen werden nur an einer Stelle erfasst, in pages/feedback/<slug>.md. Der Befehl hypomnema feedback-sync berechnet daraus automatisch MEMORY.md (Obergrenze 200 Zeilen) und <learned_behaviors> (Obergrenze 10 Einträge, strenge Prüfung von 5 Feldern) neu und übernimmt die Änderungen.
• Neu erzwungene SCHEMA-Felder: Seiten vom Typ type: feedback erzwingen 9 Pflichtfelder. upgrade --apply erstellt automatisch eine Backfill-Checkliste. Einen automatischen Entwurf (Stub) habe ich bewusst abgelehnt — wenn falsche Standardwerte einmal festgeschrieben sind, fließt stillschweigend falsches Verhalten in zwei abgeleitete Flächen (MEMORY und CLAUDE.md).
• Synchronisierung mit gebündelten Erweiterungsdateien: Im Wiki liegen zusätzlich die Verzeichnisse extensions/{agents,commands,hooks,skills}, die automatisch nach ~/.claude/ gespiegelt werden. Mit dem Flag --codex wird nach ~/.codex/ nur die Teilmenge hooks + commands gespiegelt, inklusive der Kern-Hooks.
• Mehr Automatisierung: Wenn es im aktuellen Arbeitsverzeichnis (cwd) kein Wiki-Projekt gibt, wird automatisch zur Erstellung geraten; nach dem Ende einer bedeutungsvollen Session wird automatisch ein leichtes Wrap-up (minimal crystallize) vorgeschlagen; direkt nach WebFetch / WebSearch erscheint ein Hinweis auf /hypo:ingest; Update-Benachrichtigungen über 2 Kanäle (npm / Plugin); W8-Lint-Warnung erkennt veraltete design-history.md; Korrekturen, die in andere Projekte auslaufen, werden blockiert (scope: project:* erzwingt exakte Übereinstimmung); 1. Stufe der Bereinigung von Code-Kommentaren (zeitgebundene Referenzen, deren Bedeutung mit der Zeit verschwimmt, werden entfernt, Design-Anker bleiben erhalten).

Unterschiede zu bestehendem LLM-Wiki-OSS

Aus dem Karpathy-Gist abgeleitete Projekte sind in kurzer Zeit in mehr als zehn Varianten entstanden.
Die Unterschiede nach Bereichen, soweit ich sie selbst geprüft habe, sind wie folgt.

• Bereiche, die Hypomnema hauptsächlich adressiert: Automatisierung des Session-Lifecycles (14 Hooks binden den Wiki-Betrieb an SessionStart / PreCompact / Stop usw.), Single Source of Truth für AI-Verhaltenskorrekturen + automatische unidirektionale Übernahme, automatisches Spiegeln von ~/.claude/{commands,agents,skills,hooks}.
• nvk/llm-wiki: Starke Verifikationsmodi mit --mode thesis, bei denen Agenten für und gegen eine These parallel ausgeführt werden.
• SamurAIGPT/llm-wiki-agent: Stark bei Multi-Format-Ingest für PDF / Word / PPT / Excel.
• nashsu/llm_wiki: Das ausgereifteste Electron-Desktop-GUI (6.6k stars).

Hypomnema hat Thesis-Modus, Multi-Format-Ingest und ein eigenes GUI bewusst nicht gebaut — in diesen Bereichen sind die oben genannten Projekte stärker, und bei Bedarf nutze ich parallel bestehende Tools wie Obsidian.
Kurz gesagt: Der stärkste Bereich von Hypomnema ist, das Wiki in den täglichen Workflow von Claude-Code-Nutzern hineinzuziehen.

Bestandteile

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 + kompatibel mit Claude Agent Skills.
Die detaillierte Funktionsweise der einzelnen Befehle und Hooks ist im README und im englischen Walkthrough auf dev.to beschrieben.

Bewusst weggelassen

Keine Vector DB, keine API-Keys, kein GUI, keine Mode-Matrix, keine automatischen SCHEMA-Stubs — all das wurde bewusst ausgeschlossen, entweder weil „falsche Standardwerte stillschweigend in falsches Verhalten übergehen“ oder weil „andere Tools das bereits gut machen“.

Anforderungen + Links

• Node.js ≥ 18 / Claude Code CLI
• GitHub: https://github.com/sk-lim19f/Hypomnema · npm: https://www.npmjs.com/package/hypomnema · Lizenz: MIT
• Rückblick: https://velog.io/@dlatkdrb980219/…

Hinweise zur Mitarbeit

Feedback, Issues und PRs sind willkommen.