install

install est la commande qui place BMAD+ dans un projet. Elle copie les agents et compétences des packs choisis, écrit les fichiers d’instructions que lisent vos assistants IA, crée la configuration et enregistre un manifeste de tout ce qu’elle possède, pour que update, doctor et uninstall puissent agir ensuite en sécurité. Lancez-la une fois par projet, puis à chaque fois que vous voulez ajouter un pack ou un outil.

Synopsis#

npx bmad-plus install [-d <path>] [-p <packs>] [-y] [-l <code>] [--tools <tools>] [--mode <mode>] [--provision-python]

L’assistant interactif#

Sans --yes, l’installateur pose les questions ci-dessous, dans cet ordre. Les questions de langue, de packs et d’outils sont sautées quand vous avez donné --lang, --packs ou --tools ; le nom, la langue de communication, l’environnement de test et le mode d’exécution sont toujours demandés. Core est toujours inclus dans la liste des packs, et les packs déjà installés sont présélectionnés.

1. 01

   Langue

   La langue de l’installateur (voir la vue d’ensemble de la CLI). Sautée si --lang est donné.

2. 02

   Packs

   Une sélection multiple des packs facultatifs. Sautée si --packs est donné.

3. 03

   Outils

   Demandé seulement si aucun outil d’IA n’a été détecté dans le dossier et que --tools n’est pas donné.

4. 04

   Prénom

   Votre prénom ; les agents s’en servent pour vous saluer. Par défaut : la configuration existante, puis le nom d’utilisateur du système.

5. 05

   Langue de communication

   La langue dans laquelle les agents répondent. Écrite dans la configuration.

6. 06

   Environnement de test

   L’URL d’un environnement de test pour les recettes d’acceptation humaine ; laissez vide si vous n’en avez pas.

7. 07

   Mode d’exécution

   manual (vous appelez les agents), autopilot (Nexus mène le pipeline) ou hybrid (autopilot avec des points de contrôle fréquents). Toujours demandé. Une valeur --mode l’emporte sur votre réponse.

Avec --yes, rien n’est demandé : le prénom vient de la configuration existante ou du nom d’utilisateur du système, la langue de communication de la configuration existante, de --lang ou de la langue du système, et le mode de --mode, de la configuration existante ou de manual. Une installation sans surveillance ne remplace jamais un réglage déjà présent.

Ce qu’elle lit et écrit#

La commande liste d’abord chaque fichier de chaque pack sélectionné. Si l’un d’eux ne peut pas être listé (par exemple les compétences externes du pack Design ne correspondent pas à la version épinglée), elle s’arrête avant d’écrire quoi que ce soit. Elle prend ensuite un verrou de projet, écrit les fichiers de façon atomique et termine par le manifeste. Elle n’ouvre aucune connexion réseau elle-même ; seule exception, --provision-python, qui demande à un installateur Python (uv, avec pipx ou pip en repli) de récupérer les dépendances du pack.

Relancer la commande#

• Même version : seuls les packs, outils et fichiers manquants sont ajoutés. Les packs et outils que l’installation possède déjà sont conservés et rafraîchis.
• Les fichiers que vous avez modifiés, ou qui ne sont pas enregistrés comme appartenant à BMAD+, sont préservés avec un avertissement (<file>: locally changed or unowned content preserved.).
• Vos propres fichiers d’instructions (CLAUDE.md, GEMINI.md, etc.) : une installation interactive les préserve et avertit ; avec --yes, ils sont d’abord copiés vers <file>.bak (numéroté si besoin) puis remplacés par le fichier BMAD+. Un fichier BMAD+ que vous avez modifié est toujours préservé. Les anciens fichiers BMAD+ sans empreinte de propriété sont d’abord sauvegardés en <file>.bak.
• _bmad/config.yaml est fusionné : les clés existantes l’emportent, les valeurs par défaut manquantes sont ajoutées, et les réponses données explicitement dans l’assistant (ou --mode) remplacent l’ancienne valeur. Si le fichier ne peut pas être analysé, il reste intact, avec un avertissement.
• Une version différente est refusée. Utilisez update : elle planifie le changement, sauvegarde les fichiers et enregistre un reçu.
• Un manifeste illisible est d’abord copié vers _bmad/.bmad-plus-install.json.corrupt.bak (numéroté s’il existe déjà), puis remplacé.

Codes de sortie#

Sortie réelle#

Voici l’installation enregistrée des packs Core et Design pour Claude Code, en français (--lang fr), tirée de la recette d’acceptation humaine de la 0.23.0. La ligne « 5 agents, 9 compétences, 4 fichiers copiés » compte les dossiers d’agents, les dossiers de compétences et les autres fichiers copiés. Le cadre se termine par le guide de démarrage ; ses lignes d’exemple dépendent des packs choisis (ici la ligne Design).

$ npx bmad-plus install --yes --lang fr --packs core,design --tools claude-code --directory .\demo-app
T   BMAD+ Installer v0.23.0
|
•  ✨ Created by Laurent Rochetta — github.com/lrochetta/BMAD-PLUS
|
•  Installation dans: C:\Users\you\demo-app
|
*  Packs sélectionnés: ⚙️ Core, 🎨 Design
|
•  IDE détectés: Claude Code
|
o  ✅ 5 agents, 9 skills, 4 fichiers copiés
|
o  ✅ 1 IDE configuré(s)
|
o  ✅ Installation terminée — Comment commencer -------------------------------+
|                                                                              |
|  💬 À qui parler ?                                                           |
|                                                                              |
|    Discuter d'une idée          →  "Atlas, [...]"                            |
|    Créer un PRD                 →  "Atlas, create PRD"                       |
|    Architecture technique       →  "Forge, propose architecture"             |
|    Implémenter du code          →  "Forge, implement story [X]"              |
|    Tester / code review         →  "Sentinel, review module [X]"             |
|    Planifier un sprint          →  "Nexus, create epics"                     |
|    Tout automatiser             →  "autopilot"                               |
|    Design avec Atelier          →  "/design read"                            |
|                                                                              |
|  📦 Commandes CLI:                                                           |
|    npx bmad-plus install    — Installer agents & skills                      |
|    npx bmad-plus update     — Mettre à jour (conserve la config)             |
|    npx bmad-plus doctor     — Vérifier l'installation                        |
|    npx bmad-plus uninstall  — Supprimer BMAD+ du projet                      |
|                                                                              |
|  💡 Exemples rapides:                                                        |
|    🎨 Design : "/design read" → Atelier vous interroge, puis construit       |
|                                                                              |
+------------------------------------------------------------------------------+
|
—  BMAD+ est prêt ! Parle à Atlas pour commencer 🚀

Erreurs et que faire#

Exemples#

npx bmad-plus@0.23.0 install

npx bmad-plus install --packs core,design --tools claude-code --yes --lang fr

npx bmad-plus install --packs all --tools all --yes

npx bmad-plus install --tools none --yes

npx bmad-plus install --packs seo --provision-python