Claude Code enregistre chaque session sur disque — voici comment les indexer et les retrouver

Claude Code écrit depuis le premier jour un journal JSONL en ajout seul de chaque session dans ~/.claude/projects/. Chaque ligne est un objet JSON structuré — rôle, horodatage, contenu, appels d'outils — formant un enregistrement épisodique complet remontant à votre première session. Un utilisateur a trouvé 1 026 sessions totalisant 57 Mo et 76 000 tours, toutes stockées sur disque sans moyen intégré de les interroger.

Construction d'une couche de rappel

La solution est un indexeur open-source (continuity-v2, licence MIT) qui ingère ces journaux dans SQLite+FTS5 avec des arêtes temporelles entre les tours, plus un serveur MCP. Depuis n'importe quelle session Claude Code, vous pouvez désormais exécuter :

search_sessions("souviens-toi quand on a corrigé ce bug d'auth le mois dernier")
recall_session("a8f2c441")
thread_recall(root_id, depth=8)

La fonction thread_recall effectue un parcours BFS à travers le graphe d'arêtes temporelles pour reconstruire un fil de discussion à travers les sessions. L'indexeur supporte également l'import de conversations.json depuis l'export de données de claude.ai, de sorte que l'historique des discussions web réside dans le même index que les sessions CLI.

Correction de la réinitialisation brutale de la compaction

La compaction se déclenche lorsque le contexte se remplit, mais le champ transcript_path dans la charge utile PreCompact n'est pas toujours renseigné au moment du déclenchement du hook. La solution : écrire un point de contrôle à chaque tour (pas seulement en fin de session) afin que PreCompact ait toujours des données fraîches sur lesquelles se rabattre. Ensuite, SessionStart lit le champ source — "compact" signifie que la compaction a eu lieu, "resume" un redémarrage de l'application, "startup" une nouvelle session, "clear" est intentionnel. Chacun déclenche un comportement différent. Résultat net : la compaction devient un échec de cache, pas une réinitialisation brutale.

Discussion en amont et projets similaires

Suivez la discussion en cours sur anthropics/claude-code#47023. Sept projets de mémoire indépendants (Bella, NEXO Brain, Cozempic, world-model-mcp, etc.) ont tous rencontré indépendamment les mêmes exigences. Une spécification formelle des hooks est en cours d'élaboration.

Les hooks prennent environ cinq minutes à configurer ; le serveur MCP est un seul fichier Python. Le dépôt est sous licence MIT.