Claude-Mem : une couche mémoire qui fait passer le contexte de l'agent d'une session à l'autre
Contexte persistant au cours des sessions pour chaque agent, capture tout ce que votre agent fait pendant les sessions, le compresse avec l'IA et réinjecte le contexte pertinent dans les sessions futures. Fonctionne avec Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + Plus.
En bref
- De quoi s’agit-il ?
- Un regard sur thedotmack/claude-mem, un système de compression de mémoire persistante pour Claude Code qui capture les observations de session et réinjecte le contexte pertinent dans les sessions suivantes.
- À qui s’adresse-t-il ?
- Le README de Claude-Mem décrit une couche mémoire qui enregistre ce qu'un agent fait pendant une session et le réinjecte plus tard, avec un service worker, un stockage SQLite et des outils de recherche en couches. Le dépôt est sous licence Apache-2.0, et le texte de licence accorde des droits de reproduction et de distribution étendus, sans rien dire sur le support, la sécurité ou la garantie.
- Puis-je l’utiliser commercialement ?
- Oui. Apache-2.0 est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 2 jours.
- En quel langage est-il écrit ?
- Principalement JavaScript, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 15 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Un système de compression de mémoire persistante pour Claude Code
Le README commence en décrivant Claude-Mem comme un système de compression de mémoire persistante conçu pour Claude Code. Il capture tout ce qu'un agent fait pendant les sessions, compresse cette activité avec de l'IA et réinjecte le contexte pertinent dans les sessions futures. L'objectif déclaré est de permettre à Claude de maintenir une continuité de connaissance sur un projet après la fin ou la reconnexion d'une session. La description GitHub étend la liste de compatibilité à OpenClaw, Codex, Gemini, Hermes, Copilot et OpenCode, mais le README ne donne d'instructions d'installation que pour Claude Code, OpenCode, Antigravity CLI et les passerelles OpenClaw ; les étapes pour les autres outils listés devraient être vérifiées sur le site de documentation.
Chemins d'installation et avertissement npm
Le démarrage rapide documenté est une seule commande : `npx claude-mem install`. Il existe des variantes pour OpenCode (`npx claude-mem install --ide opencode`) et Antigravity CLI (`npx claude-mem install --ide antigravity`). Les utilisateurs de Claude Code peuvent aussi ajouter la place de marché de plugins avec `/plugin marketplace add thedotmack/claude-mem`, puis exécuter `/plugin install claude-mem`, suivi d'un redémarrage de Claude Code. Le README avertit que `npm install -g claude-mem` installe uniquement le SDK/la bibliothèque et n'enregistre pas les hooks de plugin ni ne configure le service worker. Les passerelles OpenClaw utilisent un installeur séparé : `curl -fsSL https://install.cmem.ai/openclaw.sh | bash`, qui selon le README gère les dépendances, la configuration du plugin, la configuration du fournisseur d'IA, le démarrage du worker et les flux d'observation en temps réel optionnels.
Les cinq scripts de hook, le worker et le stockage
Le README décrit cinq hooks de cycle de vie (SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd), en notant qu'ils correspondent à six scripts de hook, plus un pré-hook d'installation intelligente qui vérifie les dépendances en cache. Un service worker local, géré par Bun, expose une API HTTP avec une interface de visualisation web et des points de terminaison de recherche. Le stockage utilise SQLite pour les sessions, les observations et les résumés, et une base de données vectorielle Chroma pour la recherche hybride sémantique et par mots-clés. Le README liste la compétence mem-search pour les requêtes en langage naturel avec divulgation progressive, que le projet décrit comme une récupération mémoire en couches avec visibilité des coûts en jetons. Il mentionne aussi les balises `<private>` pour exclure le contenu sensible du stockage.
Outils de recherche MCP et flux de travail en trois couches
Claude-Mem comprend quatre outils MCP qui suivent un modèle en trois couches économe en jetons. L'outil `search` renvoie un index compact avec des ID, environ 50 à 100 jetons par résultat. `timeline` fournit le contexte chronologique autour des résultats intéressants. `get_observations` récupère les détails complets uniquement pour les ID filtrés, estimés à 500 à 1 000 jetons par résultat. Le README affirme une économie de jetons d'environ 10 fois en filtrant avant de récupérer les détails. L'exemple du README montre une recherche de authentication bug, suivie d'une récupération par lots des observations pour les ID sélectionnés. Ces chiffres sont des estimations du README ; aucune méthodologie de référence n'est fournie.
Configuration, modes et exigences système
Les paramètres sont stockés dans `~/.claude-mem/settings.json`, créé automatiquement avec des valeurs par défaut au premier lancement, et couvrent le modèle IA, le port du worker, le répertoire de données, le niveau de journalisation et l'injection de contexte. Le paramètre `CLAUDE_MEM_MODE` contrôle à la fois le comportement du flux de travail (code, chill, investigation) et la langue des observations générées. Le README documente `code` comme mode anglais par défaut, `code--zh` comme chinois simplifié et `code--ja` comme japonais ; les autres langues suivent le modèle `code--[lang]`, et il est noté que `code--zh` est intégré sans installation supplémentaire. Les exigences système listées sont Node.js 20.0.0 ou supérieur, un Claude Code récent avec prise en charge des plugins, Bun (installé automatiquement s'il manque), uv pour la recherche vectorielle (installé automatiquement s'il manque) et SQLite 3 inclus.
Branches, développement et licence
Les versions stables partent de la branche `main` et sont publiées sur npm. `core-dev` et `community-edge` sont des branches exécutées depuis le source, pour les correctifs de fiabilité précoces et les intégrations communautaires. Le README demande aux contributeurs de forker le dépôt, de créer une branche de fonctionnalité, d'apporter des modifications avec des tests, de mettre à jour la documentation et de soumettre une pull request, avec un guide de développement lié pour les détails. Le projet est sous licence Apache-2.0, et le README note que le répertoire `ragtime/` porte la même licence. Le texte de la licence accorde une licence de droit d'auteur perpétuelle, mondiale, non exclusive, gratuite, sans redevance et irrévocable pour reproduire, préparer des œuvres dérivées, afficher, exécuter, sous-licencier et distribuer l'œuvre. Il ne dit rien sur le support, les garanties de sécurité ou la garantie.
La note sur le jeton CMEM
Une section à la fin du README aborde CMEM, un jeton créé par un tiers mais officiellement adopté par l'auteur du projet, Alex Newman. Le README décrit le jeton comme un catalyseur communautaire de croissance et un véhicule pour apporter CMEM aux développeurs et travailleurs du savoir qui en ont le plus besoin. Une adresse de contrat de base officielle est répertoriée, mais le README lui-même ne fournit aucun détail technique sur les mécanismes, la gouvernance ou l'utilité du jeton. Les métadonnées du dépôt indiquent 89 638 étoiles et 7 805 forks au moment de la rédaction, mais le README ne discute pas de métriques d'adoption.
Claude-Mem organise une mémoire locale pour les sessions
Le projet Claude-Mem est présenté comme un outil qui conserve et rend consultables des observations issues du travail avec Claude. Son intérêt dépend donc de la qualité de la capture, de l indexation et de la recherche dans l environnement réel. Le nom du projet ne suffit pas à établir une conservation, une confidentialité ou une compatibilité générale.
Conclusion éditoriale
Le README de Claude-Mem décrit une couche mémoire qui enregistre ce qu'un agent fait pendant une session et le réinjecte plus tard, avec un service worker, un stockage SQLite et des outils de recherche en couches. Le dépôt est sous licence Apache-2.0, et le texte de licence accorde des droits de reproduction et de distribution étendus, sans rien dire sur le support, la sécurité ou la garantie.
Notes de la communauté