# uninstall

> Aus einem Projekt entfernen, was BMAD+ gehört, und Speicher, Einstellungen sowie geänderte und unbekannte Dateien behalten: Optionen, was gelöscht wird, was bleibt, echte Ausgabe, Meldungen.

Canonical: https://bmad-plus.rochetta.fr/de/docs/reference/cli-uninstall/
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/) › uninstall

`uninstall` nimmt BMAD+ aus einem Projekt, ohne etwas von dir mitzunehmen. Es löscht nur Dateien, die nachweislich BMAD+ gehören (byteidentisch mit dem, was das Paket liefert, oder Anweisungsdateien mit BMAD+-Marke und passendem gespeichertem Hash), und das Installationsmanifest. Dein Projekt-Memory, deine Konfiguration, deine Ausgaben, alles Bearbeitete und alles Unbekannte bleibt liegen. Nutze es, um ein Projekt aufzuräumen, neu zu beginnen oder eine Installation zu testen.

<a id="synopsis"></a>
## Syntax

**Im Terminal deines Projekts**

```sh
npx bmad-plus uninstall [-d <path>] [-y] [-l <code>]
```

**Optionen von uninstall**

| Option | Argument | Was sie tut |
| --- | --- | --- |
| `-d, --directory <path>` | Ordner | Zu bereinigendes Projekt (Standard: aktueller Ordner). Muss existieren. |
| `-y, --yes` | - | Ohne Rückfrage bestätigen. Ohne Terminal Pflicht. |
| `-l, --lang <code>` | Sprachcode | Sprache der Bildschirme. Standard: die bei der Installation gespeicherte Sprache, dann Englisch. |

<a id="reads-writes"></a>
## Was entfernt wird und was bleibt

Der Befehl liest das Manifest, baut einen Löschplan, zeigt Version und Packs, fragt nach Bestätigung und prüft jeden Pfad unmittelbar vor dem Löschen erneut (symbolische Links und Junctions werden nie verfolgt). Dateien werden einzeln entfernt; Ordner nur, wenn sie leer sind. Es gibt kein rekursives Löschen.

**Schicksal jeder Dateiart**

| Was | Ergebnis |
| --- | --- |
| Agenten-, Skill-, Daten- und Pack-Dateien, die mit dem Gelieferten identisch sind (seit 0.23.0 auch die aus dem npm-Paket des Design-Packs kopierten Skills) | Entfernt. |
| `_bmad/module.yaml`, `_bmad/module-help.csv`, das Manifest `_bmad/.bmad-plus-install.json` | Entfernt (wenn identisch mit dem Gelieferten). |
| `AGENTS.md` und Tool-Dateien mit BMAD+-Marke und passendem gespeichertem Hash | Entfernt. |
| Alles davon, was du bearbeitet hast | Behalten. |
| Dateien in diesen Ordnern, die BMAD+ nicht dorthin gelegt hat | Behalten, samt ihrem Ordner. |
| `_bmad/config.yaml`, `_bmad/update-policy.json` | Behalten. |
| `.agents/memory/`, `~/.bmad-plus/brain` | Behalten. |
| `_bmad-output/` und alles, was Agenten erzeugt haben | Behalten. |
| `.bmad/` (Update-Belege, Backups, Caches) | Behalten. |
| `.agents`, `.agents/skills`, `.agents/data`, `_bmad`, `_bmad-output` und geleerte Adapter-Ordner | Nur entfernt, wenn sie nach dem Löschen leer sind. |

<a id="exit-codes"></a>
## Exit-Codes

**Exit-Codes von uninstall**

| Code | Bedeutung |
| --- | --- |
| 0 | Entfernt; oder BMAD+ ist in diesem Ordner nicht installiert (eine Warnung, nichts zu tun); oder du hast die Rückfrage abgelehnt. |
| 1 | Ordner nicht gefunden, unlesbares Manifest, kein Terminal und kein `--yes`, unsicherer Link oder ein Fehler beim Löschen. |

<a id="real-output"></a>
## Echte Ausgabe

Aufgezeichnet im Abnahmelauf von 0.23.0 (auf Französisch mit den Packs Core und Design installiert). Die Zeile, die die entfernten Elemente zählt, fehlt: Der Lauf, der sie zeigte, deckte den Fehler auf, dass die Design-Skills nicht entfernt wurden; er wurde vor der Veröffentlichung behoben. Die letzte Zeile bestätigte der korrigierte Lauf.

**Deinstallation, die Memory und Einstellungen behält**

```text
$ npx bmad-plus uninstall --yes --directory .\demo-app
T   BMAD+ Uninstaller
|
•  BMAD+ v0.23.0 (installé le 2026-10-18)
|
•  Packs sélectionnés: core, design
|
# … Zeile mit der Zahl entfernter Elemente ausgelassen …
—  La mémoire, les réglages et les fichiers inconnus ou modifiés ont été conservés.
```

Ausgabe eines echten Laufs. Quelle: Aufgezeichnet in zwei Abnahmeläufen der 0.23.0 am 2026-10-18 (Kopfzeilen, dann die letzte Zeile von Schritt 7); die Zeile der entfernten Elemente ist ausgelassen

<a id="errors"></a>
## Fehler und was zu tun ist

**Meldungen von uninstall**

| Meldung | Ursache | Was tun |
| --- | --- | --- |
| `BMAD+ is not installed in this directory.` | Kein Manifest in `_bmad/`. | Ordner prüfen oder `--directory` angeben. Exit-Code 0. |
| `Project directory not found: <dir> (ENOENT)` | Der Ordner existiert nicht. | Pfad korrigieren. |
| `Install manifest is unreadable or corrupt: ...` danach `Check _bmad/.bmad-plus-install.json and repair it before retrying.` | Das Manifest ist kein gültiges JSON oder es fehlen Felder. | Datei reparieren oder wiederherstellen, oder `install` erneut ausführen, das die defekte sichert. |
| `This command requires a terminal. Run `npx bmad-plus uninstall --yes` to proceed without prompts.` | Kein Terminal und kein `--yes`. | `--yes` ergänzen. |
| `Uninstall aborted: Symbolic link or junction: <path>` | Ein zu löschender Pfad führt über einen Link. | Link entfernen oder ersetzen und erneut versuchen. Durch ihn wurde nichts gelöscht. |
| `Uninstall aborted: Unknown installed pack: <id>` | Das Manifest nennt ein Pack, das dieses Paket nicht kennt. | Die Paketversion starten, die es installiert hat, oder das Manifest korrigieren. |

<a id="examples"></a>
## Beispiele

**Ein Projekt aufräumen und alles Eigene behalten**

```sh
npx bmad-plus uninstall --yes
```

**Danach mit frischer Installation neu beginnen**

```sh
npx bmad-plus uninstall --yes
npx bmad-plus install
```

**Siehe auch**

- [install](https://bmad-plus.rochetta.fr/de/docs/reference/cli-install/)
- [update und --restore](https://bmad-plus.rochetta.fr/de/docs/reference/cli-update/)
- [Der ganze Lebenszyklus](https://bmad-plus.rochetta.fr/de/docs/guides/install-lifecycle/)
- [Projektstruktur](https://bmad-plus.rochetta.fr/de/docs/reference/project-layout/)

[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)
