Parcourir la documentation

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.

Sur cette page
  1. Synopsis
  2. Ce qui est supprimé et ce qui reste
  3. Codes de sortie
  4. Sortie réelle
  5. Erreurs et que faire
  6. Exemples

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.

Synopsis

Dans le terminal de votre projet
npx bmad-plus uninstall [-d <path>] [-y] [-l <code>]

Options de uninstall
OptionArgumentCe qu’elle fait
-d, --directory <path>dossierProjet à nettoyer (par défaut : dossier courant). Doit exister.
-y, --yes-Confirmer sans demander. Obligatoire sans terminal.
-l, --lang <code>code de langueLangue des écrans. Par défaut, la langue enregistrée à l’installation, puis l’anglais.

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
QuoiRé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.jsonSupprimés (s’ils sont identiques à ce qui est livré).
AGENTS.md et fichiers d’outils portant la marque BMAD+ et conformes à leur empreinte enregistréeSupprimés.
Tout ce qui précède que vous avez modifiéConservé.
Fichiers de ces dossiers que BMAD+ n’y a pas misConservés, ainsi que leur dossier.
_bmad/config.yaml, _bmad/update-policy.jsonConservés.
.agents/memory/, ~/.bmad-plus/brainConservés.
_bmad-output/ et tout ce que les agents ont produitConservés.
.bmad/ (reçus de mise à jour, sauvegardes, caches)Conservé.
.agents, .agents/skills, .agents/data, _bmad, _bmad-output et les dossiers d’adaptateurs vidésSupprimés seulement s’ils sont vides après les suppressions.

Codes de sortie

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

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

Erreurs et que faire

Messages de uninstall
MessageCauseQue 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.

Exemples

Nettoyer un projet en gardant tout ce qui est à vous
npx bmad-plus uninstall --yes

Repartir ensuite sur une installation neuve
npx bmad-plus uninstall --yes
npx bmad-plus install

Voir aussi