Hypomnema - un wiki personnel LLM-native fonctionnant dans Claude Code (open source)

Hypomnema est un wiki personnel OSS LLM-native qui fonctionne dans Claude Code avec une simple slash command.
Il vit dans le dossier ~/hypomnema/ sous forme de Markdown en texte brut + git, sans service externe / clé API / base de données vectorielle.
Les sources originales fournies par l’utilisateur sont conservées telles quelles dans sources/, et les résultats synthétisés par Claude s’accumulent dans pages/.
Lorsqu’il retrouve le même sujet, il ne crée pas une nouvelle page, mais met à jour la page existante.

La raison de sa création vient de quatre problèmes accumulés à force de travailler avec l’IA au quotidien.
(1) le coût de devoir réexpliquer le contexte de la veille à chaque nouvelle session
(2) les résultats s’empilent vite, mais comme la raison de ces choix d’implémentation n’est consignée nulle part, le débogage un mois plus tard devient une dette technique encore plus coûteuse
(3) avoir essayé Notion, Obsidian et Confluence, mais voir les wikis manuels s’effondrer dans les quatre pièges : « pas d’automatisation / pas de synthèse / fossilisation / on ne les consulte plus »
(4) un court Gist de Karpathy — « RAG relit tout à chaque fois, alors qu’un wiki pérennise la connaissance synthétisée une fois. Le goulot d’étranglement a toujours été le bookkeeping, et les LLM ramènent ce coût à 0 » — a montré la voie.

J’ai donc commencé avec deux dossiers Markdown, puis ajouté des hooks de cycle de vie un par un chaque fois qu’un point agaçant apparaissait au quotidien.

Résumé des points clés

• Concept : un wiki plutôt que du RAG (Retrieval-Augmented Generation). Le LLM conserve les pages synthétisées une première fois, puis les enrichit au fil des usages. Markdown en texte brut + git, sans service externe / clé API / base de données vectorielle.
• Installation : npm install -g hypomnema → /hypo:init dans Claude Code.
• Source unique + propagation à sens unique : les corrections de comportement sont consignées en un seul endroit, pages/feedback/<slug>.md. La commande hypomnema feedback-sync recalcule et répercute automatiquement cela dans MEMORY.md (limite de 200 lignes) et <learned_behaviors> (limite de 10 éléments, validation stricte de 5 champs).
• Nouveaux champs SCHEMA obligatoires : les pages type: feedback imposent 9 champs requis. upgrade --apply génère automatiquement une checklist de backfill. Les brouillons automatiques (stub) ont été volontairement refusés — avec de mauvaises valeurs par défaut, un comportement erroné pourrait se propager silencieusement dans les deux surfaces dérivées (MEMORY et CLAUDE.md).
• Synchronisation avec fichiers d’extension inclus : le wiki embarque aussi les répertoires extensions/{agents,commands,hooks,skills} et les recopie automatiquement dans ~/.claude/. Avec le flag --codex, seul le sous-ensemble hooks + commands (y compris les hooks essentiels) est recopié dans ~/.codex/.
• Automatisation renforcée : suggestion de création automatique s’il n’existe pas de projet wiki dans le répertoire de travail actuel (cwd), suggestion automatique d’une courte phase de clôture (minimal crystallize) quand une session significative se termine, rappel de /hypo:ingest juste après WebFetch / WebSearch, alertes de mise à jour via 2 canaux (npm / plugin), avertissement lint W8 pour détecter un design-history.md obsolète, blocage des corrections qui fuient vers un autre projet (correspondance exacte imposée pour scope: project:*), et nettoyage de phase 1 des commentaires de code (suppression des références liées à un moment précis, dont le sens s’efface avec le temps, tout en conservant les ancres de conception).

Différences avec les autres OSS de wiki LLM

Une dizaine de projets dérivés du Gist de Karpathy sont apparus en peu de temps.
Voici les différences constatées par domaine après les avoir examinés directement.

• Domaines principaux de Hypomnema : automatisation du cycle de vie des sessions (14 hooks qui intègrent l’exploitation du wiki à SessionStart / PreCompact / Stop, etc.), centralisation des corrections de comportement de l’IA avec propagation automatique à sens unique, mirroring automatique de ~/.claude/{commands,agents,skills,hooks}.
• nvk/llm-wiki : très fort sur le mode de vérification avec --mode thesis, qui exécute en parallèle des agents pour et contre une proposition.
• SamurAIGPT/llm-wiki-agent : très fort sur l’ingest multi-format PDF / Word / PPT / Excel.
• nashsu/llm_wiki : GUI desktop Electron (6.6k stars) la plus mature.

Hypomnema n’a volontairement pas développé de mode thesis, d’ingest multi-format ni de GUI propre — ces projets couvrent déjà mieux ces besoins, et si nécessaire on peut les combiner avec des outils existants comme Obsidian.
En résumé, le point fort de Hypomnema est d’intégrer le wiki directement dans le workflow quotidien des utilisateurs de Claude Code.

Composants

8 slash commands (/hypo:ingest, /hypo:query, /hypo:crystallize, /hypo:resume, /hypo:feedback, /hypo:verify, /hypo:lint, /hypo:graph) + 5 sous-commandes CLI (init, upgrade [--apply] [--codex], doctor [extensions], uninstall, feedback-sync) + 14 hooks de cycle de vie + compatibilité avec Claude Agent Skills.
Le fonctionnement détaillé de chaque commande et hook est documenté dans le README et dans le walkthrough en anglais sur dev.to.

Ce qui a été exclu volontairement

Pas de base de données vectorielle, de clé API, de GUI, de matrice de modes ni de stub SCHEMA automatique — tout cela a été exclu volontairement, soit parce que « de mauvaises valeurs par défaut conduisent silencieusement à de mauvais comportements », soit parce que « d’autres outils le font déjà très bien ».

Prérequis + liens

• Node.js ≥ 18 / Claude Code CLI
• GitHub: https://github.com/sk-lim19f/Hypomnema · npm: https://www.npmjs.com/package/hypomnema · Licence: MIT
• Retour d’expérience : https://velog.io/@dlatkdrb980219/…

Contribution

Les retours, issues et PR sont les bienvenus.