Explorar la documentación
uninstall
Quitar de un proyecto lo que posee BMAD+ y conservar tu memoria, tus ajustes y los archivos editados o desconocidos: opciones, qué se borra, qué queda, salida real y mensajes posibles.
En esta página
uninstall saca BMAD+ de un proyecto sin llevarse nada tuyo. Solo borra archivos que son demostrablemente de BMAD+ (idénticos byte a byte a lo que entrega el paquete, o archivos de instrucciones con la marca de BMAD+ y que coinciden con su huella registrada) y el manifiesto de instalación. La memoria del proyecto, tu configuración, tus salidas, todo lo que editaste y todo lo que no reconoce se quedan donde están. Úsalo para limpiar un proyecto, empezar de cero o probar una instalación.
Sinopsis
npx bmad-plus uninstall [-d <path>] [-y] [-l <code>]| Opción | Argumento | Qué hace |
|---|---|---|
-d, --directory <path> | carpeta | Proyecto a limpiar (por defecto, la carpeta actual). Debe existir. |
-y, --yes | - | Confirmar sin preguntar. Obligatorio si no hay terminal. |
-l, --lang <code> | código de idioma | Idioma de las pantallas. Por defecto, el idioma registrado al instalar y luego el inglés. |
Qué se elimina y qué se queda
El comando lee el manifiesto, construye un plan de eliminación, muestra la versión y los packs, pide confirmación y vuelve a comprobar cada ruta justo antes de borrar (nunca se sigue un enlace simbólico ni una unión). Los archivos se eliminan uno a uno; las carpetas solo si están vacías. No hay borrado recursivo.
| Qué | Resultado |
|---|---|
| Archivos de agentes, habilidades, datos y packs idénticos a los que entrega el paquete (incluidas, desde la 0.23.0, las habilidades copiadas del pack npm del paquete Design) | Eliminados. |
_bmad/module.yaml, _bmad/module-help.csv, el manifiesto _bmad/.bmad-plus-install.json | Eliminados (si son idénticos a lo que se entrega). |
AGENTS.md y archivos de herramienta con la marca BMAD+ y que coinciden con su huella registrada | Eliminados. |
| Cualquiera de lo anterior que hayas editado | Conservado. |
| Archivos de esas carpetas que BMAD+ no puso allí | Conservados, y también su carpeta. |
_bmad/config.yaml, _bmad/update-policy.json | Conservados. |
.agents/memory/, ~/.bmad-plus/brain | Conservados. |
_bmad-output/ y todo lo que produjeron los agentes | Conservados. |
.bmad/ (recibos de actualización, copias, cachés) | Conservado. |
.agents, .agents/skills, .agents/data, _bmad, _bmad-output y las carpetas de adaptadores vaciadas | Se eliminan solo si quedan vacías tras los borrados. |
Códigos de salida
| Código | Significado |
|---|---|
| 0 | Eliminado; o BMAD+ no está instalado en esa carpeta (un aviso, nada que hacer); o rechazaste la pregunta. |
| 1 | Carpeta no encontrada, manifiesto ilegible, sin terminal y sin --yes, enlace inseguro, o un fallo al borrar. |
Salida real
Registrado durante la receta de aceptación de la 0.23.0 (instalado en francés con los packs Core y Design). Se omite la línea que cuenta los elementos eliminados: la ejecución que la mostró fue la que destapó el defecto por el que no se quitaban las habilidades de Design, corregido antes de publicar. La última línea es la que confirmó la ejecución corregida.
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
|
… línea del número de elementos eliminados omitida …
— La mémoire, les réglages et les fichiers inconnus ou modifiés ont été conservés.npx bmad-plus uninstall --yes --directory .\demo-appErrores y qué hacer
| Mensaje | Causa | Qué hacer |
|---|---|---|
BMAD+ is not installed in this directory. | No hay manifiesto en _bmad/. | Revisa la carpeta o pasa --directory. Código de salida 0. |
Project directory not found: <dir> (ENOENT) | La carpeta no existe. | Corrige la ruta. |
Install manifest is unreadable or corrupt: ... y luego Check _bmad/.bmad-plus-install.json and repair it before retrying. | El manifiesto no es JSON válido o le faltan campos. | Repara o restaura el archivo, o ejecuta install de nuevo, que guarda una copia del dañado. |
This command requires a terminal. Run npx bmad-plus uninstall --yes to proceed without prompts. | Sin terminal y sin --yes. | Añade --yes. |
Uninstall aborted: Symbolic link or junction: <path> | Una ruta a borrar pasa por un enlace. | Quita o sustituye el enlace y reintenta. No se borró nada a través de él. |
Uninstall aborted: Unknown installed pack: <id> | El manifiesto nombra un pack que este paquete no conoce. | Ejecuta la versión que lo instaló, o corrige el manifiesto. |
Ejemplos
npx bmad-plus uninstall --yesnpx bmad-plus uninstall --yes
npx bmad-plus installVéase también
- install install
- update y --restore update
- El ciclo completo Instalar, actualizar, desinstalar
- Estructura del proyecto Estructura del proyecto