Infrastructure de mémoire long terme GreyMatter v2.2.0macOS
Retrouvez ce que vous avez déjà décidé, appris ou essayé.
GreyMatter garde vos décisions, vos méthodes, vos erreurs et votre expérience en notes sur votre propre disque, pour qu'on les retrouve depuis une session suivante ou un autre projet. Il fonctionne aujourd'hui avec Claude Code, et se construit vers une mémoire qui reste la vôtre, quel que soit le modèle.
Stack
- Python
- Bash
- Swift
- WebGL
- GitHub Actions
- Apache 2.0
- v2.2.0
- la version publique actuelle, 30 septembre 2026, open source sous licence Apache 2.0.
- 54 versions
- publiées sur le dépôt public.
- Markdown + git
- vos notes sont de simples fichiers sur votre disque, avec tout leur historique.
- 2,4 ms
- par recherche sur 1 000 notes, sur un banc synthétique (27 septembre).
Le problème
Une nouvelle session ne reprend pas ce que la précédente a appris.
Vos règles et vos fichiers sont toujours là. Ce qui a été décidé, essayé et appris en chemin, non, sauf si quelqu'un l'écrit.
-
Lundi
Votre agent et vous trouvez pourquoi le cache casse, et décidez comment le réparer. Ça prend une heure, et la réponse est bonne.
-
Jeudi
Nouvelle session. Vous réexpliquez le cache et la décision avant de pouvoir avancer.
-
Le mois prochain
Un autre projet bute sur le même problème. La réponse existe, dans une vieille session que personne ne rouvrira : le travail est fait deux fois.
À quoi ça sert
Garder, retrouver, réutiliser.
Décisions, méthodes, erreurs, expériences, connaissances accumulées : gardées dans le temps. Trois objectifs en découlent, pas des gains mesurés.
- GARDER puis
- RETROUVER puis
- RÉUTILISER
-
Moins de recontextualisation
Ne pas reconstruire tout le contexte d’un travail déjà fait.
-
Moins de répétition
Ne pas refaire pour rien un raisonnement, une recherche, une décision ou une exploration déjà menés.
-
L'expérience passée, quand elle sert
Retrouver une expérience passée quand elle compte pour le travail en cours.
Aujourd'hui · v2.2.0
Comment ça marche aujourd'hui
Aujourd'hui, il fonctionne avec Claude Code.
GreyMatter peut transformer ce qui mérite d'être gardé d'une session Claude Code en notes Markdown reliées, versionnées avec git sur votre disque.
Barre de menus · dans la v2.2.0
Une note passe d'une session à la suivante.
Deux vraies sessions Claude Code, avec la pastille au-dessus. Ce que la première session découvre est distillé en note et classé ; la seconde la récupère avant que Claude réponde. Chaque agent s’allume sous la pastille dans sa couleur.
Filmé avec le rappel automatique allumé (BRAIN_RECALL_AUTO=1). Par défaut, le rappel attend que vous le demandiez : ?brain, brain recall, ou « cherche dans la mémoire ».
-
Distillation en fin de session
Quand une session se ferme, son transcript est archivé. Si elle a compté 20 messages ou plus, un distillateur garde ce qui mérite de l'être : de nouvelles notes, un fait chacune, avec leur source et un niveau de certitude, ou des mises à jour de notes existantes.
-
Rappel sur demande
Tapez ?brain, brain recall ou « cherche dans la mémoire » : deux ou trois notes utiles sont signalées dans le contexte. Par défaut, aucune note n'entre si vous ne le demandez pas ; une session s'ouvre avec au plus quatre points de reprise trouvés dans vos notes.
-
Une mémoire pour tous les projets
Les notes vivent dans un dépôt de mémoire partagé : une mémoire passée utile peut donc être retrouvée depuis un autre projet. Les liens entre notes se suivent à la main.
-
Quatre agents, huit missions
Distiller, classer, contester, relier, archiver, réparer, surveiller la machine, synthétiser : quatre agents se partagent ces huit tâches.
-
Revue de fraîcheur
Une note jamais revérifiée entre dans une file de revue, datée d'après l'historique git.
-
Des mises à jour qui demandent
Chaque session cherche une nouvelle version du moteur et votre agent demande avant de l'installer. brain update --rollback revient à la précédente.
- 01 Vos notes Des fichiers Markdown versionnés avec git, dans leur propre dossier, à part du moteur.
- 02 Sur demande Une recherche lexicale choisit deux ou trois notes utiles, de n’importe quel projet, et les signale dans la conversation.
- 03 Pendant la session Chaque fichier lu ou écrit est noté.
- 04 Fin de session Le transcript est archivé. Ce qui mérite d'être gardé est distillé en notes par la propre ligne de commande de Claude Code, classé, puis enregistré dans git.
Ce sur quoi le projet travaille
Durabilité, provenance, recherche, sélection du contexte.
Le travail en cours porte sur quatre choses. Chacune dit où elle en est.
-
Durabilité
Rien de ce qui a été capturé ne doit se perdre : ni dans un plantage, ni dans une mise à jour, ni dans une désinstallation.
En cours de durcissementbranche locale, plus bas
-
Provenance
Chaque nouvelle note doit dire de quelle session elle vient, avec un extrait. Les anciennes ne sont pas réécrites : toutes ne le font pas.
Aujourd'hui, pour les nouvelles notes
-
Recherche
Les bonnes notes reviennent quand vous le demandez, depuis n'importe quel projet.
Aujourd'huimesuré plus bas
-
Sélection du contexte
Ce qui entre dans le contexte de l'agent, et quand. Les notes proposées d'elles-mêmes étaient rarement ouvertes : le rappel attend donc qu'on le demande.
Aujourd'hui sur demandele reste est de la recherche
La durabilité avant l'intelligence
D'abord, rien ne se perd.
Une mémoire qui perd une session sans prévenir est pire qu'aucune mémoire, parce qu'on lui fait confiance. L'ordre du travail est donc fixé : chaque étape attend que la précédente tienne.
- DURABILITÉ passe avant
- ÉTAT VÉRIDIQUE passe avant
- RECHERCHE passe avant
- INTELLIGENCE passe avant
- MAGIE
Aujourd'hui · v2.2.0
Publié
- Le moteur et les notes vivent dans des dossiers séparés.
- Les mises à jour demandent avant de s'installer. La v2.2.0 a un mécanisme de mise à jour et de retour en arrière ; le durcissement du cycle de vie reste sur une branche de remédiation non publiée.
- Les notes sont du Markdown sous git : chaque changement a son historique.
En remédiation · branche locale, non publiée
En cours de durcissement
- Un enregistrement n'est confirmé qu'après relecture sur le disque de chaque note annoncée.
- Chaque confirmation laisse un reçu, et les écritures passent par un journal.
- Une session qui se termine alors que la ligne de commande est indisponible est mise en file et rattrapée, pas perdue.
- Un seul état calculé répond « inconnu » plutôt que de deviner.
- Installer, mettre à jour, revenir en arrière et désinstaller gardent chaque octet d'un dossier de notes existant.
OneMemory
Une mémoire, de l'expérience à la réponse.
Le chemin que suit un morceau de travail, étape par étape. Chaque étape dit ce qui en existe aujourd'hui. APPLY fait partie de TODAY comme capacité observée, mais elle reste très peu mesurée. Savoir si une mémoire retrouvée est appliquée de manière fiable et utile reste une question de recherche.
- EXPERIENCE Vous travaillez avec votre agent.
Aujourd'hui
- CAPTURE Le transcript est archivé à la fin de la session.
Aujourd'hui
- SURVIVE La session survit à un plantage ou à une ligne de commande absente.
En partie aujourd'hui · durci en remédiation
- UNDERSTAND Un distillateur écrit un fait par note.
Aujourd'hui
- PROVE Les nouvelles notes citent leur session d'origine ; chaque enregistrement laissera un reçu.
Source aujourd'hui · reçus en remédiation
- REMEMBER Les notes sont du Markdown sous git, sur votre disque.
Aujourd'hui
- FIND Deux ou trois notes reviennent quand vous demandez.
Aujourd'hui
- APPLY L'agent se sert de la note dans sa réponse. Mesuré une fois, sur un seul dépôt.
À peine mesuré
- AUJOURD'HUI S'ARRÊTE ICI
- CONTINUE La même mémoire vous suit vers un autre agent ou un autre modèle.
Direction
- BEYOND Brain, State, Library, Runtime : la direction plus bas.
Direction
La mémoire ne suffit pas
Retrouver une note, ce n'est pas s'en servir.
Chaque étape ci-dessous peut réussir pendant que la suivante échoue. Elles sont mesurées séparément ici, et celles qui ne le sont pas le disent.
- STOCKÉ n'est pas la même chose que
- EXPOSÉ n'est pas la même chose que
- SÉLECTIONNÉ n'est pas la même chose que
- RETROUVÉ n'est pas la même chose que
- APPLIQUÉ n'est pas la même chose que
- UTILE, PROUVÉ
- 4,27 %
- des notes proposées automatiquement ont été ouvertes : 139 sur 3 256 en 30 jours. Depuis le 9 septembre, le rappel attend qu'on le demande.
- 10/10 contre 0/10
- questions de test réussies avec le système complet, contre aucune sans rien. Un dépôt, un auteur, 12 août.
- À égalité avec BM25
- sur LongMemEval (26 septembre), qui ne mesure que la recherche : 96,8 % de rappel à 5, comme une simple recherche par mots-clés.
Direction · pas encore construit
Direction · au-delà de Claude Code
Les modèles changent. Votre continuité ne devrait pas.
Aujourd'hui, la continuité tient d'une session et d'un projet à l'autre, avec Claude Code. La direction : qu'elle vous appartienne, plutôt qu'au modèle qui tourne à ce moment-là, et qu'elle survive à un changement d'agent, de modèle ou de fournisseur. Le schéma dit, fonction par fonction, ce qui en existe.
Vous
Ce que vous savez, où vous en êtes et comment vous travaillez, gardé en fichiers sur votre disque.
Brain
Ce que vous savez, avez vécu et décidé.
En partie aujourd'hui : le dépôt de notes
State
Où vous en êtes, vous ou un projet, en ce moment.
En partie aujourd'hui : les points de reprise
Library
Comment vous travaillez : règles, méthodes, listes de contrôle, échecs connus.
Direction
Runtime
Ce qu'il faut mettre dans le contexte de l'agent du moment, et quand.
En partie aujourd'hui : le rappel dans Claude Code
Legacy
Ce que vous choisissez de transmettre, trié à la main. Préserver, pas simuler : rien ne parle en votre nom.
Concept seulement
Les agents qui y lisent
- Claude Code
Aujourd'hui
- Autres agents en ligne de commande
Sur demande aujourd'hui
- Le modèle de demain
Direction
Le modèle n'est pas la mémoire.
Les modèles progressent et sont remplacés, et c’est une bonne nouvelle. La continuité appartient à l’utilisateur, pas au modèle qui tourne à ce moment-là : ce que vous avez compris avec l’un d’eux ne devrait pas avoir à être réappris par le suivant.
GreyMatter garde cette part hors de tout modèle, en simples fichiers que vous pouvez lire, déplacer et supprimer.
Recherche · hypothèse
Questions ouvertes
Ce qu'on ne sait pas encore.
Chaque hypothèse vient avec le test qui la trancherait. Aucune n'est une promesse.
-
La continuité accélère le développement
Une impression personnelle, pas une mesure. Elle n'est pas revendiquée ici.
Test : les mêmes tâches, avec et sans, plusieurs personnes
-
Les notes retrouvées sont appliquées de manière fiable et utile
Un seul scénario A/B à ce jour, le 30 septembre.
Test : beaucoup de scénarios, notés à l'aveugle
-
La continuité d'un agent à l'autre
Les autres agents en ligne de commande peuvent chercher dans les notes sur demande, sans la boucle de capture automatique.
Test : un projet, deux agents, les mêmes questions
-
La consolidation
Fusionner les notes qui disent la même chose, sans perdre leurs sources.
Test : la qualité des réponses avant et après fusion
-
L'oubli adaptatif
Laisser s'effacer les notes périmées au lieu de les empiler.
Test : moins de notes, les mêmes réponses
La réalité actuelle
Ce qu'il fait, et ce qu'il ne fait pas.
Aujourd'hui · v2.2.0
Il fait
- Il transforme ce qui mérite d'être gardé d'une session Claude Code en notes Markdown reliées, sous git, sur votre disque.
- Il retrouve deux ou trois notes utiles quand vous le demandez, depuis n'importe quel projet.
- Il tient le moteur à part de vos notes ; les mises à jour demandent d'abord. Mise à jour et retour en arrière existent dans la v2.2.0 ; le durcissement du cycle de vie reste sur une branche de remédiation non publiée.
- Il tourne sur macOS, avec une pastille dans la barre de menus et une application de carte.
Aujourd'hui · limites de la v2.2.0
Il ne fait pas
- Tourner sur Linux ou Windows pour l’instant : quatre endroits supposent encore macOS.
- Tenir vos sessions à l'écart de votre fournisseur de modèle : elles y sont traitées, y compris la distillation automatique de fin de session.
- Rendre votre agent plus rapide ou plus malin : ce n'est pas revendiqué.
- Vous simuler, ou parler en votre nom.
Recherche · hypothèse
À l'étude
- Si les notes retrouvées sont appliquées de manière fiable et utile.
- La continuité d'un agent et d'un modèle à l'autre.
- La consolidation et l'oubli adaptatif.
S'installe en deux commandes.
GreyMatter s'installe comme une extension de Claude Code. Chaque session cherche une nouvelle version et demande avant de l'installer.
/plugin marketplace add Yuno15-bb/GreyMatter-engine
/plugin install greymatter@greymatterVersion publique : v2.2.0, 30 septembre 2026, macOS. Le travail de fiabilité marqué « en remédiation » vit sur une branche locale et n'est pas encore publié.
Questions
Questions fréquentes.
C'est une mémoire pour Claude Code ?
Oui, aujourd'hui. GreyMatter est construit sur les hooks de Claude Code : il distille quand une session se termine et rappelle quand vous le demandez. C'est la partie qui est livrée.
Est-ce que ça marche avec d'autres agents ?
Sur demande : d'autres agents en ligne de commande peuvent chercher dans les mêmes notes, mais sans la boucle de capture automatique. La continuité d'un agent à l'autre est une direction, pas une fonction terminée.
Est-ce que tout reste en local ?
Vos notes sont stockées en local, en Markdown sous git. Vos sessions, non : comme toute session Claude Code, elles sont traitées par votre fournisseur de modèle, y compris la distillation automatique qui tourne à la fin d'une session. GreyMatter ne crée ni compte GreyMatter ni copie hébergée de votre mémoire.
Qu’est-ce qui passe par le réseau ?
Un git fetch des versions publiées, pour chercher les mises à jour ; la distillation de fin de session, qui passe par la ligne de commande de Claude Code et atteint donc votre fournisseur ; l'application de la carte, dont le code charge sa bibliothèque 3D depuis un CDN public ; et, seulement quand la maintenance a été arrêtée par la limite d'usage, une requête d'un mot envoyée à Anthropic avec votre connexion Claude Code, pour savoir si elle peut reprendre.
Et par rapport à Mem0, Zep ou claude-mem ?
Ils traitent des problèmes voisins, souvent avec plus de portée. Sur le seul banc public de recherche lancé ici (LongMemEval, 26 septembre), GreyMatter fait jeu égal avec une simple recherche BM25 et reste proche de la recherche de claude-mem ; la mémoire complète de claude-mem, Mem0 et Zep n'ont pas été testés. Aucune supériorité n'est revendiquée.
Est-ce que mon agent sera plus rapide ou plus malin ?
Ce n'est pas revendiqué. Il donne à votre agent des notes qu'il n'aurait pas sinon. Savoir si ça fait gagner du temps reste une question ouverte, listée plus haut dans la recherche.
À qui appartient la mémoire ?
À vous. Les notes sont des fichiers sur votre disque, dans un dépôt git que vous contrôlez, lisibles sans GreyMatter. Aujourd'hui, cette continuité tient d'une session et d'un projet à l'autre avec Claude Code. Qu'elle appartienne à l'utilisateur plutôt qu'au modèle du moment, d'un agent et d'un fournisseur à l'autre, c'est la direction.
Comment le désinstaller ?
Suivez le guide d'installation. La désinstallation doit retirer le moteur et laisser votre dossier de notes tranquille, mais ce n'est pas démontré sur la v2.2.0. Tant que le travail de durabilité n'est pas publié, gardez d'abord une copie de votre dossier de notes : c'est un simple dépôt git.
Guide d'installation et de désinstallation ↗- Rôle
- Conception, architecture, extraction, publication
- Cadre
- Projet personnel · open source · 2026
- Résultat
- 54 versions publiées sous Apache 2.0 ; la v2.2.0 est sortie le 30 septembre 2026. Le travail de fiabilité marqué « en remédiation » vit sur une branche locale et n'est pas encore publié.