Memento Vault : Outil Local pour un Contexte Persistant dans les Sessions Code Claude

Memento Vault résout le problème d'oubli de contexte entre les sessions par Claude Code en capturant et récupérant automatiquement les informations pertinentes sans maintenance manuelle.

Fonctionnement

L'outil utilise des crochets qui s'intègrent au cycle de vie de Claude Code :

• À la fin d'une session : Un crochet lit la transcription, l'évalue et décide quoi conserver. Les sessions substantielles génèrent des notes atomiques écrites dans un dépôt git local. Chaque note contient une idée avec un en-tête incluant des scores de certitude et des étiquettes, ainsi que des wikiliens vers des notes connexes. Les sessions triviales obtiennent une ligne dans un journal quotidien.
• Au début d'une session : Il injecte un briefing montrant vos sessions récentes du projet et les notes de coffre les plus pertinentes pour ce sur quoi vous allez travailler.
• À chaque invite : Il recherche dans votre coffre et affiche les notes correspondantes avant que Claude ne traite votre saisie.
• À chaque lecture de fichier : Il injecte un contexte sur les zones de code que vous avez précédemment touchées.

Détails techniques

Toute la récupération utilise une recherche locale BM25 + vectorielle sans appels LLM. Le système a une latence moyenne de 472 ms par invite et ne coûte rien à exécuter. La surcharge de contexte est d'environ 149 unités d'entrée par session. La qualité de récupération obtient un score NDCG@10 = 0,892 sur LongMemEval (500 questions).

Une couche de consolidation en arrière-plan appelée Inception regroupe les notes par similarité d'incorporation et écrit des notes de motif après les sessions, identifiant les problèmes récurrents entre les projets.

L'ensemble du système utilise des fichiers markdown dans un dépôt git, consultables dans Obsidian, recherchables avec grep et comparables avec git log. Il n'y a pas de base de données, Docker ou dépendance cloud.

Installation

git clone https://github.com/sandsower/memento-vault.git
cd memento-vault
./install.sh --experimental

Prérequis : Python 3 et Claude Code. QMD ajoute la recherche sémantique (optionnel). Fonctionne sur Linux et macOS.

Le projet comprend 271 tests et est sous licence MIT.