# 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.
Canonical: https://bmad-plus.rochetta.fr/es/docs/reference/cli-uninstall/
Language: es
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT
Documentación de BMAD+ › [Referencia](https://bmad-plus.rochetta.fr/es/docs/reference/) › uninstall
`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
**En la terminal de tu proyecto**
```sh
npx bmad-plus uninstall [-d ] [-y] [-l ]
```
**Opciones de uninstall**
| Opción | Argumento | Qué hace |
| --- | --- | --- |
| `-d, --directory ` | carpeta | Proyecto a limpiar (por defecto, la carpeta actual). Debe existir. |
| `-y, --yes` | - | Confirmar sin preguntar. Obligatorio si no hay terminal. |
| `-l, --lang ` | 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.
**Destino de cada tipo de archivo**
| 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ódigos de salida de uninstall**
| 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.
**Desinstalación que conserva memoria y ajustes**
```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
|
# … 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.
```
Salida capturada de una ejecución real. Fuente: Capturado durante dos recetas de aceptación de la 0.23.0, el 2026-10-18 (líneas de cabecera y luego la última línea del paso 7); se omite la línea de elementos eliminados
## Errores y qué hacer
**Mensajes de uninstall**
| 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: (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: ` | 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: ` | El manifiesto nombra un pack que este paquete no conoce. | Ejecuta la versión que lo instaló, o corrige el manifiesto. |
## Ejemplos
**Limpiar un proyecto conservando todo lo tuyo**
```sh
npx bmad-plus uninstall --yes
```
**Empezar de nuevo después con una instalación limpia**
```sh
npx bmad-plus uninstall --yes
npx bmad-plus install
```
**Véase también**
- [install](https://bmad-plus.rochetta.fr/es/docs/reference/cli-install/)
- [update y --restore](https://bmad-plus.rochetta.fr/es/docs/reference/cli-update/)
- [El ciclo completo](https://bmad-plus.rochetta.fr/es/docs/guides/install-lifecycle/)
- [Estructura del proyecto](https://bmad-plus.rochetta.fr/es/docs/reference/project-layout/)
[Documentación de BMAD+](https://bmad-plus.rochetta.fr/es/docs/) · [Referencia](https://bmad-plus.rochetta.fr/es/docs/reference/)
[Código en GitHub](https://github.com/lrochetta/BMAD-PLUS)