# bmad-plus memory

> Lire la santé de la mémoire du projet et du cerveau global, et exporter le cerveau global dans un seul fichier Markdown. Options, lectures et écritures, sortie, codes de sortie et erreurs.

Canonical: https://bmad-plus.rochetta.fr/fr/docs/reference/cli-memory/
Language: fr
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT

Documentation BMAD+ › [Référence](https://bmad-plus.rochetta.fr/fr/docs/reference/) › bmad-plus memory

BMAD+ garde deux sortes de mémoire dans des fichiers Markdown simples. La mémoire du projet vit dans `.agents/memory/` à l’intérieur de votre projet (décisions, leçons, motifs, contexte courant et une note de passation par session). Le cerveau global vit dans `~/.bmad-plus/brain` et il est partagé par tous vos projets. `bmad-plus memory` répond à « ma mémoire est-elle en bon état ? » par un rapport en lecture seule, et peut copier le cerveau global dans un fichier portable. Elle s’adresse à qui a installé le pack Memory (l’agent Zecher) et veut le vérifier ou sauvegarder ce que le cerveau sait.

<a id="synopsis"></a>
## Synopsis

**Dans le terminal de votre projet**

```sh
npx bmad-plus memory [status] [-d <path>] [-l <code>]
npx bmad-plus memory export [-d <path>] [-l <code>]
```

**Arguments et options de memory**

| Option | Argument | Défaut | Effet |
| --- | --- | --- | --- |
| `[subcommand]` | `status` ou `export` | `status` | `status` affiche le rapport de santé ; `export` écrit le cerveau global dans un fichier du dossier du projet. Toute autre valeur affiche une erreur. |
| `-d, --directory <path>` | chemin | dossier courant | Dossier du projet : là où `.agents/memory/` est lu et où le fichier d’export est écrit. |
| `-l, --lang <code>` | en, fr, es, de, pt-br, ru, zh, he, ja, it | aucun | Acceptée par cohérence avec les autres commandes. Le rapport lui-même est toujours affiché en anglais. |

<a id="reads-writes"></a>
## Ce qu’elle lit et écrit

**Accès aux fichiers de memory**

| Sous-commande | Lit | Écrit |
| --- | --- | --- |
| `status` | `.agents/memory/decisions.md`, `lessons.md`, `patterns.md`, `context.md`, `sessions/*.md`, `.brain-link` ; dans le cerveau global `identity.yaml`, `decisions.md`, `lessons.md`, `patterns.md`, `projects/*.yaml`, `projects-index.md`. | Rien. |
| `export` | Le cerveau global : `identity.yaml`, `decisions.md`, `lessons.md`, `patterns.md` et chaque `projects/*.yaml`. | `bmad-brain-export-<YYYY-MM-DD>.md` dans le dossier du projet (remplacé s’il existe déjà ce jour-là). |

Deux détails comptent. D’abord, le rapport inspecte toujours le cerveau global dans `~/.bmad-plus/brain`, même si votre projet est relié à un autre cerveau (un dossier `_brain/` dans un répertoire parent, la variable `BMAD_PLUS_BRAIN`) ; le lien apparaît sur la ligne « Linked brain ». Ensuite, `export` ne touche pas la mémoire du projet, seulement le cerveau global. Une « entrée » dans les comptes est une ligne qui commence par `### ` dans le fichier Markdown.

<a id="exit-codes"></a>
## Codes de sortie

**Codes de sortie de memory**

| Code | Signification |
| --- | --- |
| 0 | La commande est allée au bout. Cela inclut une sous-commande inconnue et un export sans cerveau global : les deux affichent une ligne d’erreur mais ne positionnent pas de code d’échec, donc n’utilisez pas `memory` comme porte de CI. |

<a id="real-output"></a>
## Lire la sortie

Le score de santé est la part de contrôles réussis sur dix au plus. Pour la mémoire du projet, les cinq contrôles sont : `decisions.md`, `lessons.md`, `patterns.md` et `context.md` existent, et `sessions/` contient au moins une passation `.md`. Pour le cerveau global : `identity.yaml`, `decisions.md`, `lessons.md`, `patterns.md` et le dossier `projects/` existent. Une partie non installée est exclue du score au lieu de compter pour zéro. Vert à partir de 80 %, jaune à partir de 50 %.

**memory status (valeurs illustratives)** (Simulé)

```text
$ npx bmad-plus memory status
Project Memory (/home/ana/shop)
  decisions.md     ✓  3 entries  2026-10-12
  lessons.md       ✓  1 entries  2026-10-02
  patterns.md      ✓  0 entries  2026-09-30
  context.md       ✓  2026-10-17
  sessions/        ✓  2 handoff(s)
  Linked brain: /home/ana/.bmad-plus/brain
Global Brain (/home/ana/.bmad-plus/brain)
  identity.yaml    ✓
  decisions.md     ✓  0 entries
  lessons.md       ✓  0 entries
  patterns.md      ✓  0 entries
  projects/        ✓  1 project(s) indexed
  projects-index   ·
Health: 100% (10/10 checks)
Done!
```

Transcription illustrative, non capturée lors d’une exécution réelle. Source: tools/cli/commands/memory.js (branche status, modèles de messages) ; les nombres et les chemins sont inventés

**memory export (chemin illustratif)** (Simulé)

```text
$ npx bmad-plus memory export
Brain exported to: /home/ana/shop/bmad-brain-export-2026-10-18.md
Done!
```

Transcription illustrative, non capturée lors d’une exécution réelle. Source: tools/cli/commands/memory.js (branche export, modèle de message) ; le chemin est inventé

> **Remarque · À vérifier avant de partager l’export** L’export copie telles quelles vos décisions et leçons globales et vos fiches de projet, ainsi que `identity.yaml` (votre nom et votre langue). Relisez-le avant de l’envoyer à quelqu’un ou de le committer.

<a id="errors"></a>
## Erreurs et conduite à tenir

**Messages affichés par memory**

| Message | Cause | Que faire |
| --- | --- | --- |
| `Not installed. Run: npx bmad-plus install (select Memory pack)` | Il n’y a pas de dossier `.agents/memory/` dans le projet. | Installez le pack Memory : `npx bmad-plus install --packs memory`. |
| `Not initialized. Run: npx bmad-plus install (select Memory pack)` | Il n’y a pas de dossier `~/.bmad-plus/brain` sur cette machine. | Installez le pack Memory dans un projet quelconque ; il crée le cerveau global sauf s’il trouve un autre cerveau à relier. |
| `Global brain not found. Nothing to export.` | L’export ne regarde que `~/.bmad-plus/brain`. | Faites l’installation ci-dessus, ou utilisez `scan` pour commencer à remplir le cerveau. |
| `Unknown subcommand: <name>` | Autre chose que `status` ou `export`. | Utilisez `status` ou `export`. Pour le rappel et le journal, utilisez `mem`. |
| `identity.yaml    ✗ missing` | Un cerveau global sans son fichier d’identité (un « demi-cerveau »). | Relancez l’installation du pack Memory ; elle complète les fichiers manquants sans jamais écraser les existants. |

<a id="examples"></a>
## Exemples

<a id="example-cli-memory-status"></a>
### Vérifier la santé de votre mémoire

Le pack Memory est installé et vous voulez savoir ce qui manque avant de vous y fier.

**Dans votre assistant IA**

```text
Lance `bmad-plus memory status` dans ce projet et dis-moi quels fichiers de mémoire manquent ou sont vides.
```

**Ce que vous devriez obtenir** La commande affiche un bloc pour la mémoire du projet et un pour le cerveau global. Chaque fichier montre une coche ou une croix, son nombre d’entrées `### ` et sa date de dernière modification, `sessions/` indique le nombre de passation, et la dernière ligne donne le pourcentage de santé avec le nombre de contrôles réussis. Rien n’est modifié sur le disque.

<a id="example-cli-memory-export"></a>
### Sauvegarder le cerveau global

Vous allez réinstaller votre machine et voulez une copie lisible de ce que contient le cerveau.

**Dans votre assistant IA**

```text
Exporte mon cerveau global avec `bmad-plus memory export` et dis-moi où se trouve le fichier.
```

**Ce que vous devriez obtenir** Un fichier nommé `bmad-brain-export-<date>.md` est écrit dans le dossier du projet. Il commence par `# BMAD+ Brain Export` et l’heure d’export, puis une section par fichier global (`identity.yaml`, `decisions.md`, `lessons.md`, `patterns.md`) dans un bloc de code, puis une section `Projects` avec une fiche YAML par projet indexé. La commande affiche le chemin complet.

**Voir aussi**

- [mem : rappel et journal](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-mem/)
- [scan : indexer vos projets dans le cerveau](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-scan/)
- [install : ajouter le pack Memory](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-install/)
- [Arborescence du projet](https://bmad-plus.rochetta.fr/fr/docs/reference/project-layout/)
- [Dépannage](https://bmad-plus.rochetta.fr/fr/docs/faq/troubleshooting/)

[Documentation BMAD+](https://bmad-plus.rochetta.fr/fr/docs/) · [Référence](https://bmad-plus.rochetta.fr/fr/docs/reference/)

[Code sur GitHub](https://github.com/lrochetta/BMAD-PLUS)