# La línea de comandos, visión general

> Cómo ejecutar bmad-plus, las opciones comunes a todos los comandos, los idiomas del instalador, el uso sin interacción con --yes y los códigos de salida que puedes usar en scripts y CI.

Canonical: https://bmad-plus.rochetta.fr/es/docs/reference/cli-overview/
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/) › La línea de comandos, visión general

La mayor parte de BMAD+ ocurre en una conversación con tu asistente. El comando `bmad-plus` es la parte que se ejecuta en una terminal: instala los agentes en un proyecto, los mantiene al día, comprueba la instalación y da a los agentes algunas herramientas deterministas (cuestionarios, enjambres, ejecuciones de tareas duraderas, recetas de aceptación, evidencias de revisión). Esta página es para quien escribe un comando, a mano, en un script o en CI.

<a id="invocation"></a>
## Ejecutar el comando

El paquete se publica en npm como `bmad-plus` y necesita Node.js 20 o superior. Se ejecuta con `npx`, que viene con npm. Hay tres formas que importan.

**Formas de invocar bmad-plus**

| Forma | Qué hace | Úsala para |
| --- | --- | --- |
| `npx bmad-plus <command>` | Ejecuta la copia que haya en el proyecto; si no hay ninguna, npx descarga antes el paquete publicado. | La primera instalación en un proyecto. |
| `npx bmad-plus@0.23.0 install` | Ejecuta exactamente esa versión publicada. | Instalaciones reproducibles. |
| `npx --no-install bmad-plus <command>` | Solo ejecuta una copia ya instalada en local y nunca descarga código; falla si no hay ninguna. | Todo lo posterior a la primera instalación, una vez que el paquete también está instalado en el proyecto (ver la nota de abajo), y cada comando que un agente ejecuta por ti (por ejemplo `update-check`). |

> **Advertencia · --no-install necesita una copia local** El instalador no añade `bmad-plus` al `node_modules` de tu proyecto: justo después de `npx bmad-plus install`, la forma `--no-install` falla con `npx canceled due to missing packages and no YES option`. Para usarla, añade el paquete una vez con `npm install --save-dev bmad-plus`; si no, sigue con `npx bmad-plus <command>`, que descarga el paquete cuando hace falta. Los archivos `CLAUDE.md` y `AGENTS.md` generados piden al asistente que ejecute `npx --no-install bmad-plus update-check`; cuando ese comando no está disponible, el asistente omite la comprobación de actualizaciones y continúa con tu tarea.

**Comprobar qué versión se ejecuta**

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

Salida capturada de una ejecución real. Fuente: Capturado durante la receta de aceptación de la 0.23.0, el 2026-10-18 (paso 1)

> **Nota · Las palabras del chat no son comandos de shell** `bmad-help`, `autopilot` y `parallel` son instrucciones que le dices a tu asistente. Escribirlas en una terminal no hace nada. Solo existen en el shell los dieciocho comandos de la lista de abajo.

<a id="commands"></a>
## Los dieciocho comandos

**Qué comando para cada tarea**

| Comando | Para qué sirve |
| --- | --- |
| `install` | Poner los agentes, habilidades, archivos de instrucciones y la configuración en un proyecto. |
| `update` | Llevar un proyecto instalado a una versión más reciente, con copias de seguridad y un recibo desde el que restaurar. |
| `uninstall` | Quitar lo que BMAD+ posee y conservar tu memoria, tus ajustes y tus archivos editados. |
| `doctor` | Informe de salud de la instalación, de solo lectura. |
| `update-check` | Preguntar a npm si hay una versión más reciente, sin aplicarla. |
| `update-policy` | Mostrar o fijar la política del proyecto para las comprobaciones y las actualizaciones automáticas. |
| `autoconfig` | Analizar un proyecto existente, recomendar packs e instalarlos. |
| `scan` | Encontrar tus proyectos en el disco e indexarlos en el cerebro global. |
| `memory` | Informe de salud y exportación del cerebro persistente. |
| `mem` | Recordar, escribir, reforzar y observar lecciones en el diario de memoria. |
| `studio` | Listar los workflows de Dev Studio y preparar un lote de contexto de solo lectura para uno de ellos. |
| `intake` | Hacer las preguntas de un pack de pocas en pocas, registrar las respuestas, redactar el brief. |
| `swarm` | Repartir, instruir, comprobar y contar un panel, un jurado o una dispersión de subagentes. |
| `nexus` | Ejecuciones de tareas duraderas con verificación independiente y aceptación. |
| `uat` (alias `recette`) | Recetas de aceptación humana: lint, build, serve, read, gate. |
| `review` | Sellar el alcance de una revisión de código y calcular un veredicto honesto. |
| `assurance` | Casos de aseguramiento de Shield con un registro de evidencias encadenado por huellas. |
| `ai-register` | Comprobar el registro de integraciones de IA de un proyecto. |

**Véase también**

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

<a id="shared-options"></a>
## Opciones comunes

Commander, el analizador de argumentos que usa BMAD+, ofrece `-V, --version` y `-h, --help` para el programa, y `bmad-plus help <command>` o `bmad-plus <command> --help` para cada comando. Las demás opciones comunes se declaran comando por comando; esta tabla muestra dónde existe cada una.

**Opciones comunes por comando**

| Comando | `-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>` dirige el comando a una carpeta de proyecto. Sin ella se usa la carpeta actual. Los casos en que la carpeta no contiene ninguna instalación se explican en cada página.
- `-y, --yes` acepta los valores por defecto y omite todas las preguntas (ver más abajo).
- `-l, --lang <code>` elige el idioma de las pantallas del instalador (ver más abajo).
- `--json` imprime un resultado legible por máquinas en lugar de texto, para que un script pueda analizarlo.

<a id="languages"></a>
## Idiomas del instalador

Las pantallas del instalador y del desinstalador existen en diez idiomas. Todos los demás comandos escriben en inglés.

**Valores aceptados por --lang**

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

- `install` interactivo sin `--lang`: la primera pregunta es el idioma.
- `install --yes` sin `--lang`: las pantallas salen en inglés, y el idioma de comunicación escrito en la configuración sigue el idioma de tu sistema si es uno de los diez; si no, inglés.
- Un código desconocido no es un error: las pantallas vuelven al inglés.
- `uninstall` y `update` sin `--lang` usan el idioma registrado al instalar (`uiLanguage` en el manifiesto) y después el inglés.

<a id="non-interactive"></a>
## Uso sin interacción con --yes

Un script, un trabajo de CI o una tubería no tienen terminal para responder preguntas. `install`, `uninstall` y `update` se niegan a arrancar en esa situación sin `--yes`, en lugar de detenerse a medio camino de una pregunta. `scan` y `autoconfig` también aceptan `--yes` para tomar sus respuestas recomendadas.

**Cómo se ve un arranque rechazado** (Simulado)

```text
$ echo | npx bmad-plus install
This command requires a terminal. Run `npx bmad-plus install --yes` to proceed without prompts.
# Código de salida 1; no se escribió nada.
```

Transcripción ilustrativa, no capturada de una ejecución real. Fuente: tools/cli/i18n.js (noninteractive_requires_yes) y tools/cli/commands/install.js:55

**Una instalación totalmente desatendida**

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

> **Advertencia · --yes nunca adivina una herramienta** Con `--yes` y sin ninguna herramienta de IA detectada en la carpeta, `install` no escribe ningún archivo de instrucciones. Pasa `--tools <ids>` (o `--tools all`) para indicar qué asistentes preparar. Los identificadores están en la página de adaptadores.

<a id="exit-codes"></a>
## Códigos de salida

Todo comando termina con 0 si tiene éxito. Un error que ningún comando gestiona por sí mismo acaba con la línea `BMAD+: <message>` en el flujo de error y el código 1. Además, algunos comandos usan otros códigos para señalar un estado sobre el que un script puede actuar. Cuando el comando termina, BMAD+ libera la entrada de la terminal: el prompt de tu shell vuelve sin Ctrl+C.

**Códigos de salida por comando**

| Comando | Código | Significado |
| --- | --- | --- |
| `install`, `uninstall`, `update` | 1 | Cualquier fallo: sin terminal y sin `--yes`, conflicto de versión, manifiesto ilegible, actualización rechazada. Una pregunta cancelada sale con 0 en `uninstall` y `update`, con 1 en `install`. |
| `update-policy` | 1 | Combinación de opciones inválida o política ilegible. |
| `doctor` | 1 | Al menos una comprobación es un error. Los avisos solos salen con 0. |
| `update-check` | 1 | El estado empieza por `invalid-` (ejecución, instalación o política). |
| `intake` | 1 / 2 | `check`: 1 si el archivo es inválido. `plan`: 2 si el intake no está listo. Otros fallos: 1. |
| `studio` | 2 / 1 | 2 = `needs-input`, 1 = error. |
| `swarm` | 2 / 1 | 2 = `needs-approval`, 1 = `incomplete` o error. |
| `nexus` | 1 | `verify` no superado, `launch` o `collect` no completado, o error. |
| `uat` | 1 / 2 / 3 | `read` y `gate`: 0 superado, 1 fallo, 2 sin ejecución terminada, 3 respuestas sobre otra revisión de la receta. `lint` y `order`: 1 con errores o ciclos. |
| `review` | 1 / 2 / 3 | `gate`: 0 limpio, 1 hallazgos, 2 incompleto. `continue`: 3 si el código se movió. Otros errores: 3. `anchor`: 1 si un hallazgo no se localiza. |
| `assurance` | 1 / 3 | `run` y `verify`: 1 si una comprobación falla o una afirmación no está respaldada. Errores: 3. |
| `ai-register` | 1 / 3 | `check`: 1 solo si el registro es ilegible o inválido. Acción inválida o init fallido: 3. |
| `mem` | 1 | Acción desconocida o fallo. |

> **Consejo · Condicionar un script a un veredicto** Los códigos 2 y 3 son deliberados: separan «aún no está listo» o «obsoleto» de «ha fallado». En CI, trata cualquier código distinto de cero como una parada y lee la página del comando para saber de qué tipo es.

**Véase también**

- [Instalar, actualizar, desinstalar: el ciclo completo](https://bmad-plus.rochetta.fr/es/docs/guides/install-lifecycle/)
- [El archivo de configuración](https://bmad-plus.rochetta.fr/es/docs/reference/config-yaml/)
- [Herramientas compatibles y archivos que se escriben para ellas](https://bmad-plus.rochetta.fr/es/docs/reference/adapters/)
- [Solución de problemas](https://bmad-plus.rochetta.fr/es/docs/faq/troubleshooting/)

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