# uninstall

> Retirer d’un projet ce que BMAD+ possède et garder votre mémoire, vos réglages, vos fichiers modifiés ou inconnus : options, ce qui est supprimé, ce qui reste, sortie réelle et messages possibles.

Canonical: https://bmad-plus.rochetta.fr/fr/docs/reference/cli-uninstall/
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/) › uninstall

`uninstall` retire BMAD+ d’un projet sans rien emporter de ce qui est à vous. Elle ne supprime que les fichiers dont on peut prouver qu’ils sont à BMAD+ (identiques octet pour octet à ce que livre le paquet, ou fichiers d’instructions portant la marque BMAD+ et conformes à leur empreinte enregistrée) et le manifeste d’installation. La mémoire du projet, votre configuration, vos productions, tout ce que vous avez modifié et tout ce qu’elle ne reconnaît pas restent en place. Servez-vous-en pour nettoyer un projet, repartir de zéro ou tester une installation.

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

**Dans le terminal de votre projet**

```sh
npx bmad-plus uninstall [-d <path>] [-y] [-l <code>]
```

**Options de uninstall**

| Option | Argument | Ce qu’elle fait |
| --- | --- | --- |
| `-d, --directory <path>` | dossier | Projet à nettoyer (par défaut : dossier courant). Doit exister. |
| `-y, --yes` | - | Confirmer sans demander. Obligatoire sans terminal. |
| `-l, --lang <code>` | code de langue | Langue des écrans. Par défaut, la langue enregistrée à l’installation, puis l’anglais. |

<a id="reads-writes"></a>
## Ce qui est supprimé et ce qui reste

La commande lit le manifeste, construit un plan de suppression, affiche la version et les packs, demande confirmation, puis revérifie chaque chemin juste avant de supprimer (aucun lien symbolique ni jonction n’est jamais suivi). Les fichiers sont supprimés un par un ; les dossiers ne le sont que s’ils sont vides. Il n’y a aucune suppression récursive.

**Sort de chaque sorte de fichier**

| Quoi | Résultat |
| --- | --- |
| Fichiers d’agents, de compétences, de données et de packs identiques à ceux que livre le paquet (dont, depuis la 0.23.0, les compétences copiées du paquet npm du pack Design) | Supprimés. |
| `_bmad/module.yaml`, `_bmad/module-help.csv`, le manifeste `_bmad/.bmad-plus-install.json` | Supprimés (s’ils sont identiques à ce qui est livré). |
| `AGENTS.md` et fichiers d’outils portant la marque BMAD+ et conformes à leur empreinte enregistrée | Supprimés. |
| Tout ce qui précède que vous avez modifié | Conservé. |
| Fichiers de ces dossiers que BMAD+ n’y a pas mis | Conservés, ainsi que leur dossier. |
| `_bmad/config.yaml`, `_bmad/update-policy.json` | Conservés. |
| `.agents/memory/`, `~/.bmad-plus/brain` | Conservés. |
| `_bmad-output/` et tout ce que les agents ont produit | Conservés. |
| `.bmad/` (reçus de mise à jour, sauvegardes, caches) | Conservé. |
| `.agents`, `.agents/skills`, `.agents/data`, `_bmad`, `_bmad-output` et les dossiers d’adaptateurs vidés | Supprimés seulement s’ils sont vides après les suppressions. |

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

**Codes de sortie de uninstall**

| Code | Signification |
| --- | --- |
| 0 | Supprimé ; ou BMAD+ n’est pas installé dans ce dossier (avertissement, rien à faire) ; ou vous avez refusé la question. |
| 1 | Dossier introuvable, manifeste illisible, pas de terminal et pas de `--yes`, lien dangereux, ou échec pendant la suppression. |

<a id="real-output"></a>
## Sortie réelle

Enregistré pendant la recette d’acceptation de la 0.23.0 (installé en français avec les packs Core et Design). La ligne qui compte les éléments supprimés est omise : l’exécution qui l’a affichée est celle qui a révélé le défaut où les compétences Design n’étaient pas retirées, corrigé avant la publication. La dernière ligne est celle que l’exécution corrigée a confirmée.

**Désinstallation qui garde la mémoire et les réglages**

```text
$ npx bmad-plus uninstall --yes --directory .\demo-app
T   BMAD+ Uninstaller
|
•  BMAD+ v0.23.0 (installé le 2026-10-18)
|
•  Packs sélectionnés: core, design
|
# … ligne du nombre d’éléments supprimés omise …
—  La mémoire, les réglages et les fichiers inconnus ou modifiés ont été conservés.
```

Sortie capturée lors d’une exécution réelle. Source: Capturé pendant deux recettes d’acceptation de la 0.23.0, le 2026-10-18 (lignes d’en-tête, puis dernière ligne de l’étape 7) ; la ligne des éléments retirés est omise

<a id="errors"></a>
## Erreurs et que faire

**Messages de uninstall**

| Message | Cause | Que faire |
| --- | --- | --- |
| `BMAD+ is not installed in this directory.` | Pas de manifeste dans `_bmad/`. | Vérifiez le dossier ou passez `--directory`. Code de sortie 0. |
| `Project directory not found: <dir> (ENOENT)` | Le dossier n’existe pas. | Corrigez le chemin. |
| `Install manifest is unreadable or corrupt: ...` puis `Check _bmad/.bmad-plus-install.json and repair it before retrying.` | Le manifeste n’est pas du JSON valide ou il manque des champs. | Réparez ou restaurez le fichier, ou relancez `install`, qui sauvegarde l’abîmé. |
| `This command requires a terminal. Run `npx bmad-plus uninstall --yes` to proceed without prompts.` | Pas de terminal et pas de `--yes`. | Ajoutez `--yes`. |
| `Uninstall aborted: Symbolic link or junction: <path>` | Un chemin à supprimer passe par un lien. | Supprimez ou remplacez le lien, puis réessayez. Rien n’a été supprimé à travers lui. |
| `Uninstall aborted: Unknown installed pack: <id>` | Le manifeste nomme un pack inconnu de ce paquet. | Lancez la version du paquet qui l’a installé, ou corrigez le manifeste. |

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

**Nettoyer un projet en gardant tout ce qui est à vous**

```sh
npx bmad-plus uninstall --yes
```

**Repartir ensuite sur une installation neuve**

```sh
npx bmad-plus uninstall --yes
npx bmad-plus install
```

**Voir aussi**

- [install](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-install/)
- [update et --restore](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-update/)
- [Tout le cycle de vie](https://bmad-plus.rochetta.fr/fr/docs/guides/install-lifecycle/)
- [Arborescence du projet](https://bmad-plus.rochetta.fr/fr/docs/reference/project-layout/)

[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)
