Dokumentation durchsuchen
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.
Auf dieser Seite
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.
Syntax
npx bmad-plus uninstall [-d <path>] [-y] [-l <code>]| 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. |
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.
| 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. |
Exit-Codes
| 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. |
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.
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.npx bmad-plus uninstall --yes --directory .\demo-appFehler und was zu tun ist
| 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. |
Beispiele
npx bmad-plus uninstall --yesnpx bmad-plus uninstall --yes
npx bmad-plus installSiehe auch
- install install
- update und --restore update
- Der ganze Lebenszyklus Installieren, aktualisieren, deinstallieren
- Projektstruktur Projektstruktur