# install > Installer les agents, compétences, fichiers d’instructions et la configuration BMAD+ dans un projet : chaque option, ce qui est écrit, une réinstallation, la sortie réelle et les erreurs possibles. Canonical: https://bmad-plus.rochetta.fr/fr/docs/reference/cli-install/ 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/) › 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 **Dans le terminal de votre projet** ```sh npx bmad-plus install [-d ] [-p ] [-y] [-l ] [--tools ] [--mode ] [--provision-python] ``` **Options de install** | Option | Argument | Défaut | Ce qu’elle fait | | --- | --- | --- | --- | | `-d, --directory ` | dossier | dossier courant | Projet dans lequel installer. | | `-p, --packs ` | liste séparée par des virgules | demandé en interactif | Identifiants de packs : `core`, `osint`, `maker`, `shield`, `seo`, `memory`, `dev-studio`, `backup`, `animated`, `design`, ou `all` (tous), ou `none`. Core est toujours installé. Un identifiant inconnu est une erreur. | | `-y, --yes` | - | désactivé | Accepter toutes les valeurs par défaut et sauter les questions. Obligatoire sans terminal. | | `-l, --lang ` | code de langue | demandé, ou `en` avec `--yes` | Langue des écrans de l’installateur : `en`, `fr`, `es`, `de`, `pt-br`, `ru`, `zh`, `he`, `ja`, `it`. | | `--tools ` | liste séparée par des virgules | détection automatique | Pour quels assistants écrire des fichiers d’instructions : identifiants (`claude-code`, `gemini-cli`, `antigravity`, `cursor`, `codex-cli`, `opencode`, `aider`), `all`, ou `none` / `skip` pour ne pas toucher à la configuration des outils. | | `--mode ` | `manual`, `autopilot`, `hybrid` | valeur existante, sinon `manual` | Mode d’exécution écrit dans `_bmad/config.yaml`. Une valeur explicite remplace l’existante. | | `--provision-python` | - | désactivé | Créer un environnement Python isolé sous `.bmad/venv//` pour les packs qui en ont besoin (aujourd’hui : SEO). Ne s’exécute jamais sans demande. | ## 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. **Langue** La langue de l’installateur (voir la vue d’ensemble de la CLI). Sautée si `--lang` est donné. 2. **Packs** Une sélection multiple des packs facultatifs. Sautée si `--packs` est donné. 3. **Outils** Demandé seulement si aucun outil d’IA n’a été détecté dans le dossier et que `--tools` n’est pas donné. 4. **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. **Langue de communication** La langue dans laquelle les agents répondent. Écrite dans la configuration. 6. **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. **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. **Fichiers et dossiers écrits par install** | Chemin | De quoi il s’agit | | --- | --- | | `.agents/skills/` | Agents, compétences et dossiers de packs des packs sélectionnés. | | `.agents/data/` | Données partagées, notamment `role-triggers.yaml` (activation automatique des rôles). | | `_bmad/module.yaml`, `_bmad/module-help.csv` | Description du module et index d’aide. | | `_bmad/config.yaml` | La configuration de votre projet. Créée, ou fusionnée en gardant les clés existantes. | | `_bmad/.bmad-plus-install.json` | Le manifeste : version, packs, outils, empreintes des adaptateurs, inventaire des fichiers possédés, mode, utilisateur et langue. | | `AGENTS.md` et fichiers d’outils | Fichiers d’instructions des outils sélectionnés (voir la page des adaptateurs). Non écrits avec `--tools none`. | | `_bmad-output/discovery/`, `_bmad-output/build/`, `docs/` | Dossiers de sortie vides où écrivent les agents. | | `.agents/memory/`, `~/.bmad-plus/brain` | Avec le pack Memory : fichiers de mémoire du projet et, si besoin, un cerveau global. Un échec ici est un avertissement, pas une erreur. | | `.bmad/venv//` | Seulement avec `--provision-python`. | | `.bmad/update.lock` | Tenu pendant l’exécution, puis supprimé. | > **Remarque · Votre .gitignore vous appartient** L’installateur ne modifie pas `.gitignore`. Que les dossiers installés apparaissent dans `git status` dépend de vos propres règles d’exclusion. Dans la recette enregistrée, le projet de démonstration les ignorait déjà : `git status --short` est resté vide. ## 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 (`: 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 `.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 `.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 **Codes de sortie de install** | Code | Signification | | --- | --- | | 0 | Installé, ou plus rien à ajouter. | | 1 | Pas de terminal et pas de `--yes` ; conflit de version ; pack, outil ou mode inconnu ; un pack qui ne peut pas être listé ; verrou tenu par une autre installation ou mise à jour ; question annulée. | ## 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). **Installation sans surveillance, Core + Design, Claude Code** ```text $ 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 🚀 ``` Sortie capturée lors d’une exécution réelle. Source: Capturé pendant la recette d’acceptation de la 0.23.0, le 2026-10-18 (étape 1; lignes npm notice retirées ; l’encadré de démarrage rapide est abrégé (lignes du workflow et du dossier de sortie omises)) ## Erreurs et que faire **Messages de install** | Message | Cause | Que faire | | --- | --- | --- | | `This command requires a terminal. Run ...` | L’entrée n’est pas un terminal (script, CI, tube) et `--yes` manque. | Ajoutez `--yes` et, si vous voulez des adaptateurs, `--tools `. | | `BMAD+: Unknown pack ID(s): x. Available: core, osint, maker, shield, seo, memory, dev-studio, backup, animated, design, all.` | Un identifiant de pack de `--packs` est mal orthographié. | Utilisez l’un des identifiants listés. | | `BMAD+: Unknown tool ID(s): x. Available: claude-code, gemini-cli, antigravity, cursor, codex-cli, opencode, aider, all, none.` | Un identifiant d’outil de `--tools` est mal orthographié. | Utilisez l’un des identifiants listés. | | `BMAD+: Unknown execution mode: x` | `--mode` n’est ni `manual`, ni `autopilot`, ni `hybrid`. | Choisissez l’un des trois. | | `BMAD+ v0.22.0 is installed; this package is v0.23.0. Run `bmad-plus update` first ...` | Le projet contient une autre version que le paquet lancé. | Lancez `update`, puis relancez `install` pour ajouter packs ou outils. | | `Downgrade refused: BMAD+ vX is installed and this package is vY.` | Le paquet lancé est plus ancien que l’installation. | Lancez un paquet plus récent : `npx bmad-plus@latest install`. | | `Another update is in progress: .` | Une autre installation ou mise à jour tient `.bmad/update.lock`. | Attendez. Si elle a été interrompue, `doctor` indique quand le verrou devient périmé et quel fichier supprimer. | | `: existing project instructions preserved.` | Ce fichier d’instructions existe déjà et n’est pas celui de BMAD+ (installation interactive), ou vous avez modifié le fichier BMAD+. | Rien ne casse : le fichier pivot `AGENTS.md` porte les instructions communes. Fusionnez à la main, ou déplacez votre fichier et relancez. Avec `--yes`, votre fichier aurait été sauvegardé en `.bak` puis remplacé. | | `External module design-skill is X but this BMAD+ expects exactly Y; reinstall bmad-plus so its pinned dependency matches.` | Les compétences externes du pack Design ne correspondent pas à la version épinglée par cette version. | Réinstallez le paquet (`npm install` ou `npx bmad-plus@`). Le projet n’a pas été touché. | | `Installation changed while preparing install. Please retry.` | Un autre processus a modifié le manifeste pendant la vérification préalable. | Relancez la commande. | | `_bmad/config.yaml could not be parsed; it was left unchanged.` | Le fichier n’est pas du YAML valide. | Corrigez le fichier, puis relancez pour fusionner les valeurs par défaut. | | `Memory/brain initialization failed (non-fatal, install continues): ...` | Le dossier personnel est en lecture seule ou absent (conteneur, CI). | Sans conséquence ; définissez `BMAD_PLUS_BRAIN` vers un dossier inscriptible si vous voulez le cerveau global. | ## Exemples **En interactif, le cas courant** ```sh npx bmad-plus@0.23.0 install ``` **Sans surveillance, deux packs, un assistant** ```sh npx bmad-plus install --packs core,design --tools claude-code --yes --lang fr ``` **Tout, pour tous les assistants** ```sh npx bmad-plus install --packs all --tools all --yes ``` **Agents et compétences seulement, aucun fichier d’instructions touché** ```sh npx bmad-plus install --tools none --yes ``` **Pack SEO avec son environnement Python** ```sh npx bmad-plus install --packs seo --provision-python ``` **Voir aussi** - [Vue d’ensemble de la CLI](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-overview/) - [Vérifier le résultat avec doctor](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-doctor/) - [Passer à une version plus récente](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-update/) - [Adaptateurs et identifiants d’outils](https://bmad-plus.rochetta.fr/fr/docs/reference/adapters/) - [La configuration écrite](https://bmad-plus.rochetta.fr/fr/docs/reference/config-yaml/) - [Tout le cycle de vie](https://bmad-plus.rochetta.fr/fr/docs/guides/install-lifecycle/) - [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)