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.

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.

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

Les dix-huit commandes#

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.

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

Langues de l’installateur#

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

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

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.

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

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

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.