Mémoire autonome

Lorsqu’elle est activée, l’agent extrait automatiquement les connaissances durables des sessions passées et injecte un résumé compact dans chaque nouvelle session. Au fil du temps, il construit un magasin de mémoire à l’échelle du projet — décisions techniques, flux de travail récurrents, pièges — qui se perpétue sans effort manuel.

Désactivée par défaut. Activez-la via /settings ou config.yml :

memories:
  enabled: true

Utilisation

Ce qui est injecté

Au démarrage de la session, si un résumé de mémoire existe pour le projet en cours, il est injecté dans le prompt système sous forme de bloc Memory Guidance. L’agent reçoit l’instruction de :

Traiter la mémoire comme un contexte heuristique — utile pour les processus et les décisions antérieures, mais ne faisant pas autorité sur l’état actuel du dépôt.
Citer le chemin de l’artefact mémoire lorsque la mémoire modifie le plan, et l’associer à des preuves issues du dépôt actuel avant d’agir.
Privilégier l’état du dépôt et les instructions de l’utilisateur en cas de conflit avec la mémoire ; traiter la mémoire conflictuelle comme obsolète.

Lecture des artefacts mémoire

L’agent peut lire directement les fichiers mémoire en utilisant les URL memory:// avec l’outil read :

URL	Contenu
`memory://root`	Résumé compact injecté au démarrage
`memory://root/MEMORY.md`	Document complet de mémoire à long terme
`memory://root/skills/<name>/SKILL.md`	Un guide procédural de compétence généré

Commande slash `/memory`

Sous-commande	Effet
`view`	Afficher le contenu d’injection mémoire actuel
`clear` / `reset`	Supprimer toutes les données mémoire et les artefacts générés
`enqueue` / `rebuild`	Forcer la consolidation à s’exécuter au prochain démarrage

Fonctionnement

Les mémoires sont construites par un pipeline en arrière-plan qui s’exécute au démarrage ou est déclenché manuellement via une commande slash.

Phase 1 — extraction par session : Pour chaque session passée ayant changé depuis son dernier traitement, un modèle lit l’historique de la session et extrait le signal durable : décisions techniques, contraintes, échecs résolus, flux de travail récurrents. Les sessions trop récentes, trop anciennes ou actuellement actives sont ignorées. Chaque extraction produit un bloc de mémoire brut et un court synopsis pour cette session.

Phase 2 — consolidation : Après l’extraction, une seconde passe de modèle lit toutes les extractions par session et produit trois sorties écrites sur le disque :

MEMORY.md — un document de mémoire à long terme organisé
memory_summary.md — le texte compact injecté au démarrage de la session
skills/ — des guides procéduraux réutilisables, chacun dans son propre sous-répertoire

La Phase 2 utilise un bail pour empêcher les doubles exécutions lorsque plusieurs processus démarrent simultanément. Les répertoires de compétences obsolètes issus d’exécutions précédentes sont automatiquement élagués.

Toutes les sorties sont analysées pour détecter les secrets avant d’être écrites sur le disque.

Comportement de l’extraction

Le comportement d’extraction et de consolidation de la mémoire est entièrement piloté par des fichiers de prompts statiques dans src/prompts/memories/.

Fichier	Objectif	Variables
`stage_one_system.md`	Prompt système pour l’extraction par session	—
`stage_one_input.md`	Modèle de tour utilisateur encapsulant le contenu de la session	`{{thread_id}}`, `{{response_items_json}}`
`consolidation.md`	Prompt pour la consolidation inter-sessions	`{{raw_memories}}`, `{{rollout_summaries}}`
`read_path.md`	Guidance mémoire injectée dans les sessions actives	`{{memory_summary}}`

Sélection du modèle

La mémoire s’appuie sur le système de rôles de modèle.

Phase	Rôle	Objectif
Phase 1 (extraction)	`default`	Extraction de connaissances par session
Phase 2 (consolidation)	`smol`	Synthèse inter-sessions

Si smol n’est pas configuré, la Phase 2 se rabat sur le rôle default.

Configuration

Paramètre	Défaut	Description
`memories.enabled`	`false`	Interrupteur principal
`memories.maxRolloutAgeDays`	`30`	Les sessions plus anciennes que cette valeur ne sont pas traitées
`memories.minRolloutIdleHours`	`12`	Les sessions actives plus récemment que cette valeur sont ignorées
`memories.maxRolloutsPerStartup`	`64`	Plafond de sessions traitées lors d’un seul démarrage
`memories.summaryInjectionTokenLimit`	`5000`	Nombre maximal de tokens du résumé injecté dans le prompt système

Des paramètres de réglage supplémentaires (concurrence, durées de bail, budgets de tokens) sont disponibles dans la configuration pour un usage avancé.

Fichiers clés

src/memories/index.ts — orchestration du pipeline, injection, gestion des commandes slash
src/memories/storage.ts — file d’attente de tâches et registre de threads basés sur SQLite
src/prompts/memories/ — modèles de prompts mémoire
src/internal-urls/memory-protocol.ts — gestionnaire d’URL memory://