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.

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.

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

Los dieciocho comandos#

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.

• -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.

Idiomas del instalador#

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

• 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.

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.

$ 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.

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

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.