# La ligne de commande, vue d’ensemble

> Comment lancer bmad-plus, les options communes à toutes les commandes, les langues de l’installateur, l’usage sans interaction avec --yes et les codes de sortie utilisables en script et en CI.

Canonical: https://bmad-plus.rochetta.fr/fr/docs/reference/cli-overview/
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/) › La ligne de commande, vue d’ensemble

L’essentiel de BMAD+ se passe en conversation avec votre assistant. La commande `bmad-plus` est la partie qui tourne dans un terminal : elle installe les agents dans un projet, les maintient à jour, vérifie l’installation et fournit aux agents quelques outils déterministes (questionnaires, essaims, exécutions de tâches durables, recettes d’acceptation, preuves de revue). Cette page s’adresse à toute personne qui tape une commande, à la main, dans un script ou en CI.

<a id="invocation"></a>
## Lancer la commande

Le paquet est publié sur npm sous le nom `bmad-plus` et demande Node.js 20 ou plus récent. On le lance avec `npx`, fourni avec npm. Trois formes comptent.

**Façons d’invoquer bmad-plus**

| Forme | Ce qu’elle fait | À utiliser pour |
| --- | --- | --- |
| `npx bmad-plus <command>` | Lance la copie présente dans le projet ; s’il n’y en a pas, npx télécharge d’abord le paquet publié. | La première installation dans un projet. |
| `npx bmad-plus@0.23.0 install` | Lance exactement cette version publiée. | Des installations reproductibles. |
| `npx --no-install bmad-plus <command>` | Ne lance qu’une copie déjà installée en local et ne télécharge jamais de code ; échoue s’il n’y en a pas. | Tout ce qui suit la première installation, une fois le paquet aussi installé dans le projet (voir la note ci-dessous), et chaque commande qu’un agent lance pour vous (par exemple `update-check`). |

> **Attention · Prérequis de --no-install** L’installateur n’ajoute pas `bmad-plus` au `node_modules` de votre projet : juste après `npx bmad-plus install`, la forme `--no-install` échoue avec `npx canceled due to missing packages and no YES option`. Pour l’utiliser, ajoutez le paquet une fois avec `npm install --save-dev bmad-plus` ; sinon continuez avec `npx bmad-plus <command>`, qui télécharge le paquet au besoin. Les fichiers `CLAUDE.md` et `AGENTS.md` générés demandent à l’assistant de lancer `npx --no-install bmad-plus update-check` ; quand cette commande n’est pas disponible, l’assistant saute la vérification de mise à jour et poursuit votre tâche.

**Vérifier quelle version tourne**

```text
$ npx --no-install bmad-plus --version
0.23.0
```

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)

> **Remarque · Les mots du chat ne sont pas des commandes shell** `bmad-help`, `autopilot` et `parallel` sont des instructions que vous dites à votre assistant. Les taper dans un terminal ne fait rien. Seules les dix-huit commandes listées plus bas existent dans le shell.

<a id="commands"></a>
## Les dix-huit commandes

**Quelle commande pour quel besoin**

| Commande | À quoi elle sert |
| --- | --- |
| `install` | Poser les agents, compétences, fichiers d’instructions et la configuration dans un projet. |
| `update` | Faire passer un projet installé à une version plus récente, avec sauvegardes et un reçu dont vous pouvez restaurer. |
| `uninstall` | Retirer ce que BMAD+ possède et garder votre mémoire, vos réglages et vos fichiers modifiés. |
| `doctor` | Rapport de santé de l’installation, en lecture seule. |
| `update-check` | Demander à npm s’il existe une version plus récente, sans l’appliquer. |
| `update-policy` | Afficher ou fixer la politique du projet pour les vérifications et les mises à jour automatiques. |
| `autoconfig` | Analyser un projet existant, recommander des packs, les installer. |
| `scan` | Retrouver vos projets sur le disque et les indexer dans le cerveau global. |
| `memory` | Rapport de santé et export du cerveau persistant. |
| `mem` | Rappeler, écrire, renforcer et observer des leçons dans le journal de mémoire. |
| `studio` | Lister les workflows de Dev Studio et préparer un lot de contexte en lecture seule pour l’un d’eux. |
| `intake` | Poser les questions d’un pack par petits lots, enregistrer les réponses, rédiger le brief. |
| `swarm` | Tirer, briefer, contrôler et compter un panel, un jury ou un fanout de sous-agents. |
| `nexus` | Exécutions de tâches durables avec vérification indépendante et acceptation. |
| `uat` (alias `recette`) | Recettes d’acceptation humaine : lint, build, serve, read, gate. |
| `review` | Sceller le périmètre d’une revue de code et calculer un verdict honnête. |
| `assurance` | Dossiers d’assurance Shield avec un registre de preuves chaîné par empreintes. |
| `ai-register` | Vérifier le registre des intégrations d’IA d’un projet. |

**Voir aussi**

- [install](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-install/)
- [update](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-update/)
- [uninstall](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-uninstall/)
- [doctor](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-doctor/)
- [update-check](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-update-check/)
- [update-policy](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-update-policy/)
- [autoconfig](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-autoconfig/)
- [scan](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-scan/)
- [memory](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-memory/)
- [mem](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-mem/)
- [studio](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-studio/)
- [intake](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-intake/)
- [swarm](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-swarm/)
- [nexus](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-nexus/)
- [uat](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-uat/)
- [review](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-review/)
- [assurance](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-assurance/)
- [ai-register](https://bmad-plus.rochetta.fr/fr/docs/reference/cli-ai-register/)

<a id="shared-options"></a>
## Les options communes

Commander, l’analyseur d’arguments utilisé par BMAD+, fournit `-V, --version` et `-h, --help` pour le programme, et `bmad-plus help <command>` ou `bmad-plus <command> --help` pour chaque commande. Les autres options communes sont déclarées commande par commande ; ce tableau montre exactement où chacune existe.

**Options communes par commande**

| Commande | `-d, --directory <path>` | `-y, --yes` | `-l, --lang <code>` | `--json` |
| --- | --- | --- | --- | --- |
| `install` | ✓ | ✓ | ✓ | – |
| `update` | ✓ | ✓ | ✓ | – |
| `uninstall` | ✓ | ✓ | ✓ | – |
| `doctor` | ✓ | – | ✓ | ✓ |
| `scan [path]` | ✓ | ✓ | ✓ | – |
| `memory [subcommand]` | ✓ | – | ✓ | – |
| `autoconfig` | ✓ | ✓ | ✓ | – |
| `mem <action> [query...]` | ✓ | – | – | ✓ |
| `update-check`, `update-policy`, `studio`, `nexus`, `swarm`, `uat`, `review`, `assurance`, `ai-register`, `intake` | ✓ | – | – | ✓ |

- `-d, --directory <path>` dirige la commande vers un dossier de projet. Sans elle, le dossier courant est utilisé. Les cas où le dossier ne contient aucune installation sont expliqués sur chaque page.
- `-y, --yes` accepte les valeurs par défaut et saute toutes les questions (voir plus bas).
- `-l, --lang <code>` choisit la langue des écrans de l’installateur (voir plus bas).
- `--json` affiche un résultat lisible par une machine au lieu du texte, pour qu’un script puisse l’analyser.

<a id="languages"></a>
## Langues de l’installateur

Les écrans de l’installateur et du désinstallateur existent en dix langues. Toutes les autres commandes écrivent en anglais.

**Valeurs acceptées par --lang**

| Code | Langue |
| --- | --- |
| `en` | English |
| `fr` | Français |
| `es` | Español |
| `de` | Deutsch |
| `pt-br` | Português (Brasil) |
| `ru` | Русский |
| `zh` | 中文 (简体) |
| `he` | עברית |
| `ja` | 日本語 |
| `it` | Italiano |

- `install` interactif sans `--lang` : la première question porte sur la langue.
- `install --yes` sans `--lang` : les écrans sont en anglais, et la langue de communication écrite dans la configuration suit la langue de votre système si elle fait partie des dix, sinon l’anglais.
- Un code inconnu n’est pas une erreur : les écrans retombent sur l’anglais.
- `uninstall` et `update` sans `--lang` utilisent la langue enregistrée à l’installation (`uiLanguage` dans le manifeste), puis l’anglais.

<a id="non-interactive"></a>
## Usage sans interaction avec --yes

Un script, un job de CI ou un tube n’a pas de terminal pour répondre aux questions. `install`, `uninstall` et `update` refusent de démarrer dans cette situation sans `--yes`, plutôt que de s’arrêter au milieu d’une question. `scan` et `autoconfig` acceptent aussi `--yes` pour prendre leurs réponses recommandées.

**À quoi ressemble un démarrage refusé** (Simulé)

```text
$ echo | npx bmad-plus install
This command requires a terminal. Run `npx bmad-plus install --yes` to proceed without prompts.
# Code de sortie 1 ; rien n’a été écrit.
```

Transcription illustrative, non capturée lors d’une exécution réelle. Source: tools/cli/i18n.js (noninteractive_requires_yes) et tools/cli/commands/install.js:55

**Une installation entièrement sans surveillance**

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

> **Attention · --yes ne devine jamais un outil** Avec `--yes` et aucun outil d’IA détecté dans le dossier, `install` n’écrit aucun fichier d’instructions. Passez `--tools <ids>` (ou `--tools all`) pour dire quels assistants préparer. Les identifiants sont sur la page des adaptateurs.

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

Toute commande se termine par 0 en cas de succès. Une erreur qu’aucune commande ne traite elle-même se termine par la ligne `BMAD+: <message>` sur le flux d’erreur et le code 1. Au-delà, certaines commandes emploient d’autres codes pour signaler un état sur lequel un script peut agir. Une fois la commande terminée, BMAD+ libère l’entrée du terminal : l’invite de votre shell revient sans Ctrl+C.

**Codes de sortie par commande**

| Commande | Code | Signification |
| --- | --- | --- |
| `install`, `uninstall`, `update` | 1 | Tout échec : pas de terminal et pas de `--yes`, conflit de version, manifeste illisible, mise à jour refusée. Une question annulée sort avec 0 pour `uninstall` et `update`, avec 1 pour `install`. |
| `update-policy` | 1 | Combinaison d’options invalide ou politique illisible. |
| `doctor` | 1 | Au moins un contrôle est en erreur. Les avertissements seuls sortent avec 0. |
| `update-check` | 1 | Le statut commence par `invalid-` (exécution, installation ou politique). |
| `intake` | 1 / 2 | `check` : 1 si le fichier est invalide. `plan` : 2 si l’intake n’est pas prêt. Autres échecs : 1. |
| `studio` | 2 / 1 | 2 = `needs-input`, 1 = erreur. |
| `swarm` | 2 / 1 | 2 = `needs-approval`, 1 = `incomplete` ou erreur. |
| `nexus` | 1 | `verify` non réussi, `launch` ou `collect` non terminé, ou erreur. |
| `uat` | 1 / 2 / 3 | `read` et `gate` : 0 réussi, 1 échec, 2 aucune exécution terminée, 3 réponses sur une autre révision de la recette. `lint` et `order` : 1 en cas d’erreurs ou de cycles. |
| `review` | 1 / 2 / 3 | `gate` : 0 propre, 1 constats, 2 incomplet. `continue` : 3 si le code a bougé. Autres erreurs : 3. `anchor` : 1 si un constat n’est pas localisé. |
| `assurance` | 1 / 3 | `run` et `verify` : 1 si un contrôle échoue ou si une affirmation n’est pas étayée. Erreurs : 3. |
| `ai-register` | 1 / 3 | `check` : 1 seulement si le registre est illisible ou invalide. Action invalide ou init en échec : 3. |
| `mem` | 1 | Action inconnue ou échec. |

> **Astuce · Conditionner un script à un verdict** Les codes 2 et 3 sont voulus : ils séparent « pas encore prêt » ou « périmé » de « échec ». En CI, traitez tout code non nul comme un arrêt, et lisez la page de la commande pour savoir de quel arrêt il s’agit.

**Voir aussi**

- [Installer, mettre à jour, désinstaller : tout le cycle de vie](https://bmad-plus.rochetta.fr/fr/docs/guides/install-lifecycle/)
- [Le fichier de configuration](https://bmad-plus.rochetta.fr/fr/docs/reference/config-yaml/)
- [Outils pris en charge et fichiers écrits pour eux](https://bmad-plus.rochetta.fr/fr/docs/reference/adapters/)
- [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)