brain-cli — une CLI de mémoire locale pour ajouter une mémoire à long terme à Claude Code

Claude Code oublie tout dès qu’une session se termine.
On se remet à traquer un bug repéré il y a trois semaines, et à rediscuter une décision d’architecture prise le mois dernier.
J’ai aussi essayé le serveur MCP Memory, mais la dépendance au cloud et la qualité de recherche instable posaient problème.

J’ai donc mis en place une mémoire à long terme pour l’agent en m’appuyant uniquement sur des fichiers Markdown locaux dans ~/Brain/.

---

Cas d’usage :

① Reprendre aujourd’hui une session commencée hier
brain-cli recall -b -g "bug de connexion"
→ restaure immédiatement où l’on s’était arrêté hier et ce qui a déjà été tenté

② Éviter de déboguer deux fois le même bug
En consignant les symptômes, la cause et le correctif,
recall affiche d’abord la solution quand la même erreur réapparaît dans une session suivante

③ Les décisions restent en mémoire
L’agent ne repose pas des questions du type « Pourquoi utiliser SQLite plutôt que Redis ? »
Le contexte de la décision, les alternatives examinées et la raison du choix restent tous accessibles sous forme d’enregistrements consultables

④ Plusieurs instances de Claude partagent la même mémoire
Claude dans VS Code et Claude dans le terminal lisent et écrivent dans le même Brain
Un bug corrigé d’un côté ne sera pas recorrigé par une autre instance

⑤ Automatisation complète avec les hooks de CLAUDE.md
Il suffit d’ajouter une ligne recall au hook SessionStart
pour que les souvenirs pertinents soient automatiquement restaurés au début de chaque session

---

npm install -g @ernham/brain-cli
À l’installation, le répertoire ~/Brain/ est créé et la routine recall est ajoutée automatiquement à CLAUDE.md

GitHub: https://github.com/ernham1/brain-cli | licence MIT | 87 tests