Die Kommandozeile im Überblick

Das Meiste von BMAD+ passiert im Gespräch mit deinem Assistenten. Der Befehl bmad-plus ist der Teil, der im Terminal läuft: Er installiert die Agenten in ein Projekt, hält sie aktuell, prüft die Installation und gibt den Agenten einige deterministische Helfer (Fragebögen, Schwärme, dauerhafte Task-Läufe, Abnahmeprotokolle, Review-Belege). Diese Seite ist für alle, die einen Befehl tippen, von Hand, in einem Skript oder in CI.

Den Befehl starten#

Das Paket ist auf npm als bmad-plus veröffentlicht und braucht Node.js 20 oder neuer. Du startest es mit npx, das zu npm gehört. Drei Formen sind wichtig.

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

Die achtzehn Befehle#

Gemeinsame Optionen#

Commander, der Argument-Parser von BMAD+, liefert -V, --version und -h, --help für das Programm sowie bmad-plus help <command> oder bmad-plus <command> --help für jeden Befehl. Die übrigen gemeinsamen Optionen sind pro Befehl deklariert; die Tabelle zeigt genau, wo es welche gibt.

• -d, --directory <path> richtet den Befehl auf einen Projektordner. Ohne Angabe gilt der aktuelle Ordner. Was passiert, wenn der Ordner keine Installation enthält, steht auf der jeweiligen Seite.
• -y, --yes übernimmt die Standardwerte und überspringt alle Rückfragen (siehe unten).
• -l, --lang <code> wählt die Sprache der Installer-Bildschirme (siehe unten).
• --json gibt statt Text ein maschinenlesbares Ergebnis aus, damit ein Skript es auswerten kann.

Sprachen des Installers#

Die Bildschirme von Installer und Deinstaller gibt es in zehn Sprachen. Alle anderen Befehle geben Englisch aus.

• Interaktives install ohne --lang: Die erste Frage ist die Sprache.
• install --yes ohne --lang: Die Bildschirme sind englisch, und die in die Konfiguration geschriebene Kommunikationssprache folgt deiner Systemsprache, wenn sie zu den zehn gehört, sonst Englisch.
• Ein unbekannter Code ist kein Fehler: Die Bildschirme fallen auf Englisch zurück.
• uninstall und update ohne --lang nutzen die bei der Installation gespeicherte Sprache (uiLanguage im Manifest), danach Englisch.

Betrieb ohne Rückfragen mit --yes#

Ein Skript, ein CI-Job oder eine Pipe hat kein Terminal, um Fragen zu beantworten. install, uninstall und update starten in dieser Lage nur mit --yes, statt mitten in einer Rückfrage stehen zu bleiben. scan und autoconfig nehmen mit --yes ebenfalls ihre empfohlenen Antworten.

$ echo | npx bmad-plus install
This command requires a terminal. Run `npx bmad-plus install --yes` to proceed without prompts.
# Exit-Code 1; es wurde nichts geschrieben.

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

Exit-Codes#

Jeder Befehl endet bei Erfolg mit 0. Ein Fehler, den kein Befehl selbst behandelt, endet mit der Zeile BMAD+: <message> auf dem Fehlerstrom und Exit-Code 1. Darüber hinaus melden einige Befehle mit weiteren Codes einen Zustand, auf den ein Skript reagieren kann. Nach Abschluss eines Befehls gibt BMAD+ die Terminaleingabe frei, sodass dein Shell-Prompt ohne Strg+C zurückkehrt.