Système de mémoire persistante open-source pour Claude Code résolvant la perte de contexte entre les sessions

Un développeur a créé un système de mémoire persistante pour Claude Code qui résout le problème courant de perte de contexte entre les conversations. Le système fonctionne aux côtés de Claude Code sans nécessiter de plugins ni de clés API.

Fonctionnement

Le système opère via trois composants principaux :

• Pendant les conversations, Claude écrit des notes d'une ligne dans memory/inbox.md pour capturer les décisions importantes, les identifiants et les leçons apprises
• Une tâche cron nocturne extrait les transcriptions de conversation (enregistrées sous forme de fichiers JSONL dans ~/.claude/projects/) et les combine avec les entrées de la boîte de réception dans un journal quotidien
• Au début de chaque nouvelle conversation, Claude lit les 2 derniers jours de journaux via les règles CLAUDE.md

Processus d'installation

L'installation nécessite des étapes minimales :

git clone https://github.com/Sunnyztj/claude-code-memory.git
cd claude-code-memory
./setup.sh ~/projects/memory
# Ajoutez les règles de mémoire à votre CLAUDE.md
# Configurez une tâche cron nocturne

Ce qui est mémorisé automatiquement

• Décisions d'architecture (ex : "passage de MongoDB à PostgreSQL")
• Détails de déploiement (ex : "IP du VPS modifiée, nouvelle configuration Nginx")
• Leçons apprises (ex : "Docker COPY utilise par défaut root:600, nécessite chmod")
• Informations de compte, clés API, jalons du projet

Décisions de conception clés

• Approche basée sur fichiers (pas une base de données) — permet à Claude de lire/écrire directement, compatible avec git et fonctionne hors ligne
• Modèle de boîte de réception — une ligne par entrée avec zéro friction pour la capture
• Extraction JSONL incrémentielle — suit les décalages d'octets et ne retraite jamais les anciennes conversations
• Basé sur cron (pas en processus) — fonctionne avec Claude Code standard sans plugins

Le système fonctionne avec n'importe quelle configuration Claude Code et inclut des modèles de tâches cron optionnels pour les utilisateurs de ClaudeClaw (mode démon). Le développeur rapporte l'utiliser quotidiennement en production avec des améliorations significatives dans la rétention du contexte.