install

install ist der Befehl, der BMAD+ in ein Projekt bringt. Er kopiert Agenten und Skills der gewählten Packs, schreibt die Anweisungsdateien, die deine KI-Assistenten lesen, legt die Konfiguration an und führt ein Manifest über alles, was ihm gehört, damit update, doctor und uninstall später sicher handeln können. Führe ihn einmal pro Projekt aus und erneut, wenn du ein Pack oder ein Tool hinzufügen willst.

Syntax#

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

Der interaktive Assistent#

Ohne --yes stellt der Installer die folgenden Fragen in dieser Reihenfolge. Die Fragen nach Sprache, Packs und Tools entfallen, wenn du --lang, --packs oder --tools angegeben hast; Name, Kommunikationssprache, Testumgebung und Ausführungsmodus werden immer gefragt. Core ist in der Pack-Liste immer enthalten, bereits installierte Packs sind vorausgewählt.

1. 01

   Sprache

   Die Sprache des Installers (siehe CLI-Überblick). Entfällt bei --lang.

2. 02

   Packs

   Eine Mehrfachauswahl der optionalen Packs. Entfällt bei --packs.

3. 03

   Tools

   Nur gefragt, wenn im Ordner kein KI-Tool erkannt wurde und --tools fehlt.

4. 04

   Name

   Dein Vorname; Agenten begrüßen dich damit. Standard: die vorhandene Konfiguration, dann dein Systembenutzername.

5. 05

   Kommunikationssprache

   Die Sprache, in der Agenten antworten. Wird in die Konfiguration geschrieben.

6. 06

   Testumgebung

   Die URL einer Testumgebung für menschliche Abnahmeprotokolle; leer lassen, wenn du keine hast.

7. 07

   Ausführungsmodus

   manual (du rufst die Agenten), autopilot (Nexus führt die Pipeline) oder hybrid (Autopilot mit häufigen Checkpoints). Wird immer gefragt. Ein --mode-Wert hat Vorrang vor deiner Antwort.

Mit --yes wird nichts gefragt: Der Name kommt aus der vorhandenen Konfiguration oder dem Systembenutzernamen, die Kommunikationssprache aus der vorhandenen Konfiguration, --lang oder der Systemsprache, der Modus aus --mode, der vorhandenen Konfiguration oder manual. Eine unbeaufsichtigte Installation ersetzt nie eine bereits vorhandene Einstellung.

Was gelesen und geschrieben wird#

Der Befehl listet zuerst jede Datei jedes gewählten Packs auf. Lässt sich eine nicht auflisten (etwa weil die externen Skills des Design-Packs nicht zur festgelegten Version passen), stoppt er, bevor etwas geschrieben wird. Danach setzt er eine Projektsperre, schreibt Dateien atomar und beendet mit dem Manifest. Er öffnet selbst keine Netzwerkverbindung; die einzige Ausnahme ist --provision-python, das einen Python-Installer (uv, mit pipx oder pip als Rückfall) die Anforderungen des Packs holen lässt.

Erneut ausführen#

• Gleiche Version: Es werden nur fehlende Packs, Tools und Dateien ergänzt. Packs und Tools, die die Installation schon besitzt, bleiben erhalten und werden aufgefrischt.
• Dateien, die du geändert hast oder die nicht als BMAD+-eigen verzeichnet sind, bleiben mit einer Warnung erhalten (<file>: locally changed or unowned content preserved.).
• Deine eigenen Anweisungsdateien (CLAUDE.md, GEMINI.md usw.): Eine interaktive Installation erhält sie und warnt; mit --yes werden sie zuerst nach <file>.bak kopiert (nummeriert, falls nötig) und dann durch die BMAD+-Datei ersetzt. Eine von dir bearbeitete BMAD+-Datei bleibt immer erhalten. Ältere BMAD+-Dateien ohne Besitz-Hashes werden zuerst als <file>.bak gesichert.
• _bmad/config.yaml wird zusammengeführt: Vorhandene Schlüssel gewinnen, fehlende Standardwerte werden ergänzt, und im Assistenten ausdrücklich gegebene Antworten (oder --mode) ersetzen den alten Wert. Lässt sich die Datei nicht parsen, bleibt sie unverändert, mit Warnung.
• Eine andere Version wird abgelehnt. Nimm update: Es plant die Änderung, sichert Dateien und schreibt einen Beleg.
• Ein unlesbares Manifest wird zuerst nach _bmad/.bmad-plus-install.json.corrupt.bak kopiert (nummeriert, falls vorhanden) und dann ersetzt.

Exit-Codes#

Echte Ausgabe#

Das ist die aufgezeichnete Installation der Packs Core und Design für Claude Code, auf Französisch (--lang fr), aus dem menschlichen Abnahmelauf von 0.23.0. Die Zeile „5 agents, 9 skills, 4 fichiers copiés“ zählt kopierte Agentenordner, Skill-Ordner und sonstige Dateien. Der Kasten endet mit der Startanleitung; ihre Beispielzeilen hängen von den gewählten Packs ab (hier die Design-Zeile).

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

Fehler und was zu tun ist#

Beispiele#

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