# Die Kommandozeile im Überblick

> Wie du bmad-plus startest, welche Optionen alle Befehle teilen, die Sprachen des Installers, der Betrieb ohne Rückfragen mit --yes und die Exit-Codes für Skripte und CI.

Canonical: https://bmad-plus.rochetta.fr/de/docs/reference/cli-overview/
Language: de
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT

BMAD+ Dokumentation › [Referenz](https://bmad-plus.rochetta.fr/de/docs/reference/) › 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.

<a id="invocation"></a>
## 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.

**Wege, bmad-plus aufzurufen**

| Form | Was sie tut | Verwenden für |
| --- | --- | --- |
| `npx bmad-plus <command>` | Startet die Kopie im Projekt; gibt es keine, lädt npx zuerst das veröffentlichte Paket. | Die erste Installation in einem Projekt. |
| `npx bmad-plus@0.23.0 install` | Startet genau diese veröffentlichte Version. | Reproduzierbare Installationen. |
| `npx --no-install bmad-plus <command>` | Startet nur eine bereits lokal installierte Kopie und lädt nie Code nach; ohne Kopie schlägt der Aufruf fehl. | Alles nach der ersten Installation, sobald das Paket auch im Projekt installiert ist (siehe den Hinweis unten), und jeden Befehl, den ein Agent für dich ausführt (zum Beispiel `update-check`). |

> **Warnung · --no-install braucht eine lokale Kopie** Der Installer legt `bmad-plus` nicht im `node_modules` deines Projekts ab: Direkt nach `npx bmad-plus install` scheitert die Form `--no-install` mit `npx canceled due to missing packages and no YES option`. Um sie zu nutzen, füge das Paket einmal mit `npm install --save-dev bmad-plus` hinzu; andernfalls bleib bei `npx bmad-plus <command>`, das das Paket bei Bedarf lädt. Die erzeugten `CLAUDE.md` und `AGENTS.md` weisen den Assistenten an, `npx --no-install bmad-plus update-check` auszuführen; ist dieser Befehl nicht verfügbar, überspringt der Assistent die Update-Prüfung und macht mit deiner Aufgabe weiter.

**Prüfen, welche Version läuft**

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

Ausgabe eines echten Laufs. Quelle: Aufgezeichnet im Abnahmelauf der 0.23.0 am 2026-10-18 (Schritt 1)

> **Hinweis · Chat-Wörter sind keine Shell-Befehle** `bmad-help`, `autopilot` und `parallel` sind Anweisungen an deinen Assistenten. Im Terminal getippt bewirken sie nichts. In der Shell gibt es nur die achtzehn unten aufgeführten Befehle.

<a id="commands"></a>
## Die achtzehn Befehle

**Welcher Befehl für welche Aufgabe**

| Befehl | Wofür er da ist |
| --- | --- |
| `install` | Agenten, Skills, Anweisungsdateien und Konfiguration in ein Projekt legen. |
| `update` | Ein installiertes Projekt auf eine neuere Version bringen, mit Backups und einem Beleg, aus dem du wiederherstellen kannst. |
| `uninstall` | Entfernen, was BMAD+ gehört, und deinen Speicher, deine Einstellungen und geänderte Dateien behalten. |
| `doctor` | Gesundheitsbericht der Installation, nur lesend. |
| `update-check` | npm fragen, ob es eine neuere Version gibt, ohne sie anzuwenden. |
| `update-policy` | Die Projektrichtlinie für Update-Prüfungen und automatische Updates anzeigen oder setzen. |
| `autoconfig` | Ein bestehendes Projekt analysieren, Packs empfehlen und installieren. |
| `scan` | Deine Projekte auf der Platte finden und im globalen Brain indizieren. |
| `memory` | Gesundheitsbericht und Export des persistenten Brains. |
| `mem` | Erkenntnisse im Memory-Journal abrufen, schreiben, verstärken und beobachten. |
| `studio` | Dev-Studio-Workflows auflisten und für einen davon ein schreibgeschütztes Kontextpaket vorbereiten. |
| `intake` | Die Fragen eines Packs in kleinen Gruppen stellen, Antworten festhalten, das Briefing erzeugen. |
| `swarm` | Ein Panel, eine Jury oder einen Fanout von Sub-Agenten ziehen, briefen, prüfen und auszählen. |
| `nexus` | Dauerhafte Task-Läufe mit unabhängiger Prüfung und Abnahme. |
| `uat` (Alias `recette`) | Menschliche Abnahmeprotokolle: lint, build, serve, read, gate. |
| `review` | Den Umfang eines Code-Reviews versiegeln und ein ehrliches Urteil berechnen. |
| `assurance` | Shield-Assurance-Cases mit einem per Hash verketteten Nachweisregister. |
| `ai-register` | Das Register der KI-Integrationen eines Projekts prüfen. |

**Siehe auch**

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

<a id="shared-options"></a>
## 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.

**Gemeinsame Optionen je Befehl**

| Befehl | `-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>` 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.

<a id="languages"></a>
## Sprachen des Installers

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

**Werte für --lang**

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

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

<a id="non-interactive"></a>
## 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.

**So sieht ein verweigerter Start aus** (Simuliert)

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

Beispielhafter Ablauf, nicht bei einem echten Lauf aufgezeichnet. Quelle: tools/cli/i18n.js (noninteractive_requires_yes) und tools/cli/commands/install.js:55

**Eine vollständig unbeaufsichtigte Installation**

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

> **Warnung · --yes rät nie ein Tool** Mit `--yes` und ohne erkanntes KI-Tool im Ordner schreibt `install` gar keine Anweisungsdatei. Gib `--tools <ids>` (oder `--tools all`) an, um zu sagen, welche Assistenten vorbereitet werden. Die IDs stehen auf der Seite zu den Adaptern.

<a id="exit-codes"></a>
## 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.

**Exit-Codes je Befehl**

| Befehl | Code | Bedeutung |
| --- | --- | --- |
| `install`, `uninstall`, `update` | 1 | Jeder Fehler: kein Terminal und kein `--yes`, Versionskonflikt, unlesbares Manifest, abgelehntes Update. Eine abgebrochene Rückfrage endet bei `uninstall` und `update` mit 0, bei `install` mit 1. |
| `update-policy` | 1 | Ungültige Optionskombination oder unlesbare Richtlinie. |
| `doctor` | 1 | Mindestens eine Prüfung ist ein Fehler. Nur Warnungen enden mit 0. |
| `update-check` | 1 | Der Status beginnt mit `invalid-` (Laufzeit, Installation oder Richtlinie). |
| `intake` | 1 / 2 | `check`: 1, wenn die Datei ungültig ist. `plan`: 2, wenn der Intake nicht bereit ist. Sonstige Fehler: 1. |
| `studio` | 2 / 1 | 2 = `needs-input`, 1 = Fehler. |
| `swarm` | 2 / 1 | 2 = `needs-approval`, 1 = `incomplete` oder Fehler. |
| `nexus` | 1 | `verify` nicht bestanden, `launch` oder `collect` nicht abgeschlossen, oder Fehler. |
| `uat` | 1 / 2 / 3 | `read` und `gate`: 0 bestanden, 1 gescheitert, 2 kein beendeter Lauf, 3 Antworten zu einer anderen Revision des Protokolls. `lint` und `order`: 1 bei Fehlern oder Zyklen. |
| `review` | 1 / 2 / 3 | `gate`: 0 sauber, 1 Befunde, 2 unvollständig. `continue`: 3, wenn sich der Code bewegt hat. Sonstige Fehler: 3. `anchor`: 1, wenn ein Befund nicht lokalisiert ist. |
| `assurance` | 1 / 3 | `run` und `verify`: 1, wenn eine Prüfung scheitert oder eine Aussage nicht belegt ist. Fehler: 3. |
| `ai-register` | 1 / 3 | `check`: 1 nur bei unlesbarem oder ungültigem Register. Ungültige Aktion oder fehlgeschlagenes Init: 3. |
| `mem` | 1 | Unbekannte Aktion oder Fehler. |

> **Tipp · Ein Skript an ein Urteil knüpfen** Die Codes 2 und 3 sind Absicht: Sie trennen „noch nicht bereit“ oder „veraltet“ von „gescheitert“. Behandle in CI jeden Code ungleich null als Halt und lies die Seite des Befehls, um zu wissen, welche Art Halt es ist.

**Siehe auch**

- [Installieren, aktualisieren, deinstallieren: der ganze Lebenszyklus](https://bmad-plus.rochetta.fr/de/docs/guides/install-lifecycle/)
- [Die Konfigurationsdatei](https://bmad-plus.rochetta.fr/de/docs/reference/config-yaml/)
- [Unterstützte Tools und die für sie geschriebenen Dateien](https://bmad-plus.rochetta.fr/de/docs/reference/adapters/)
- [Fehlerbehebung](https://bmad-plus.rochetta.fr/de/docs/faq/troubleshooting/)

[BMAD+ Dokumentation](https://bmad-plus.rochetta.fr/de/docs/) · [Referenz](https://bmad-plus.rochetta.fr/de/docs/reference/)

[Quellcode auf GitHub](https://github.com/lrochetta/BMAD-PLUS)