Installation non-interactive

Utilisez les options de ligne de commande pour installer BMad de manière non-interactive. Cela est utile pour :

Quand utiliser cette méthode

Déploiements automatisés et pipelines CI/CD
Installations scriptées
Installations par lots sur plusieurs projets
Installations rapides avec des configurations connues

Options disponibles

Options d’installation

Option	Description	Exemple
`--directory <chemin>`	Répertoire d’installation	`--directory ~/projects/myapp`
`--modules <modules>`	IDs de modules séparés par des virgules	`--modules bmm,bmb`
`--tools <outils>`	IDs d’outils/IDE séparés par des virgules (utilisez `none` pour ignorer)	`--tools claude-code,cursor` ou `--tools none`
`--custom-content <chemins>`	Chemins vers des modules personnalisés séparés par des virgules	`--custom-content ~/my-module,~/another-module`
`--action <type>`	Action pour les installations existantes : `install` (par défaut), `update`, ou `quick-update`	`--action quick-update`

Configuration principale

Option	Description	Par défaut
`--user-name <nom>`	Nom à utiliser par les agents	Nom d’utilisateur système
`--communication-language <langue>`	Langue de communication des agents	Anglais
`--document-output-language <langue>`	Langue de sortie des documents	Anglais
`--output-folder <chemin>`	Chemin du dossier de sortie	_bmad-output

Autres options

Option	Description
`-y, --yes`	Accepter tous les paramètres par défaut et ignorer les invites
`-d, --debug`	Activer la sortie de débogage pour la génération du manifeste

IDs de modules

IDs de modules disponibles pour l’option --modules :

bmm — méthode BMad Master
bmb — BMad Builder

Consultez le registre BMad pour les modules externes disponibles.

IDs d’outils/IDE

IDs d’outils disponibles pour l’option --tools :

Recommandés : claude-code, cursor

Exécutez npx bmad-method install de manière interactive une fois pour voir la liste complète actuelle des outils pris en charge, ou consultez la configuration des codes de la plateforme.

Modes d’installation

Mode	Description	Exemple
Entièrement non-interactif	Fournir toutes les options pour ignorer toutes les invites	`npx bmad-method install --directory . --modules bmm --tools claude-code --yes`
Semi-interactif	Fournir certains options ; BMad demande les autres	`npx bmad-method install --directory . --modules bmm`
Paramètres par défaut uniquement	Accepter tous les paramètres par défaut avec `-y`	`npx bmad-method install --yes`
Sans outils	Ignorer la configuration des outils/IDE	`npx bmad-method install --modules bmm --tools none`

Exemples

Installation dans un pipeline CI/CD

#!/bin/bash
npx bmad-method install \
  --directory "${GITHUB_WORKSPACE}" \
  --modules bmm \
  --tools claude-code \
  --user-name "CI Bot" \
  --communication-language Français \
  --document-output-language Français \
  --output-folder _bmad-output \
  --yes

Mettre à jour une installation existante

npx bmad-method install \
  --directory ~/projects/myapp \
  --action update \
  --modules bmm,bmb,custom-module

Mise à jour rapide (conserver les paramètres)

npx bmad-method install \
  --directory ~/projects/myapp \
  --action quick-update

Installation avec du contenu personnalisé

npx bmad-method install \
  --directory ~/projects/myapp \
  --modules bmm \
  --custom-content ~/my-custom-module,~/another-module \
  --tools claude-code

Ce que vous obtenez

Un répertoire _bmad/ entièrement configuré dans votre projet
Des agents et des flux de travail configurés pour vos modules et outils sélectionnés
Un dossier _bmad-output/ pour les artefacts générés

Validation et gestion des erreurs

BMad valide toutes les options fournis :

Directory — Doit être un chemin valide avec des permissions d’écriture
Modules — Avertit des IDs de modules invalides (mais n’échoue pas)
Tools — Avertit des IDs d’outils invalides (mais n’échoue pas)
Custom Content — Chaque chemin doit contenir un fichier module.yaml valide
Action — Doit être l’une des suivantes : install, update, quick-update

Les valeurs invalides entraîneront soit :

L’affichage d’un message d’erreur suivi d’un exit (pour les options critiques comme le répertoire)
Un avertissement puis la continuation de l’installation (pour les éléments optionnels comme le contenu personnalisé)
Un retour aux invites interactives (pour les valeurs requises manquantes)

Résolution des problèmes

L’installation échoue avec “Invalid directory”

Le chemin du répertoire doit exister (ou son parent doit exister)
Vous avez besoin des permissions d’écriture
Le chemin doit être absolu ou correctement relatif au répertoire actuel

Module non trouvé

Vérifiez que l’ID du module est correct
Les modules externes doivent être disponibles dans le registre

Chemin de contenu personnalisé invalide

Assurez-vous que chaque chemin de contenu personnalisé :

Pointe vers un répertoire
Contient un fichier module.yaml à la racine
Possède un champ code dans module.yaml