install

install es el comando que coloca BMAD+ en un proyecto. Copia los agentes y habilidades de los packs que elijas, escribe los archivos de instrucciones que leen tus asistentes de IA, crea la configuración y registra un manifiesto de todo lo que posee para que update, doctor y uninstall puedan actuar después con seguridad. Ejecútalo una vez por proyecto, y de nuevo cuando quieras añadir un pack o una herramienta.

Sinopsis#

npx bmad-plus install [-d <path>] [-p <packs>] [-y] [-l <code>] [--tools <tools>] [--mode <mode>] [--provision-python]

El asistente interactivo#

Sin --yes, el instalador hace las preguntas de abajo, en este orden. Las preguntas de idioma, packs y herramientas se omiten si diste --lang, --packs o --tools; el nombre, el idioma de comunicación, el entorno de pruebas y el modo de ejecución se preguntan siempre. Core siempre está incluido en la lista de packs, y los packs ya instalados aparecen preseleccionados.

1. 01

   Idioma

   El idioma del instalador (ver la visión general de la CLI). Se omite si das --lang.

2. 02

   Packs

   Una selección múltiple de los packs opcionales. Se omite si das --packs.

3. 03

   Herramientas

   Solo se pregunta si no se detectó ninguna herramienta de IA en la carpeta y no das --tools.

4. 04

   Nombre

   Tu nombre de pila; los agentes lo usan para saludarte. Por defecto, la configuración existente y luego el nombre de usuario del sistema.

5. 05

   Idioma de comunicación

   El idioma en que responden los agentes. Se escribe en la configuración.

6. 06

   Entorno de pruebas

   La URL de un entorno de pruebas para las recetas de aceptación humana; déjala en blanco si no tienes.

7. 07

   Modo de ejecución

   manual (tú llamas a los agentes), autopilot (Nexus lleva el pipeline) o hybrid (autopilot con puntos de control frecuentes). Siempre se pregunta. Un valor de --mode prevalece sobre tu respuesta.

Con --yes no se pregunta nada: el nombre sale de la configuración existente o del usuario del sistema, el idioma de comunicación de la configuración existente, de --lang o del idioma del sistema, y el modo de --mode, de la configuración existente o de manual. Una instalación desatendida nunca sustituye un ajuste que ya existe.

Qué lee y qué escribe#

El comando lista primero cada archivo de cada pack seleccionado. Si alguno no se puede listar (por ejemplo, las habilidades externas del pack Design no coinciden con la versión fijada), se detiene antes de escribir nada. Después toma un bloqueo de proyecto, escribe los archivos de forma atómica y termina con el manifiesto. No abre ninguna conexión de red por sí mismo; la única excepción es --provision-python, que pide a un instalador de Python (uv, con pipx o pip de reserva) que obtenga los requisitos del pack.

Volver a ejecutarlo#

• Misma versión: solo se añaden los packs, herramientas y archivos que faltan. Los packs y herramientas que la instalación ya posee se conservan y se refrescan.
• Los archivos que cambiaste, o que no constan como de BMAD+, se conservan con un aviso (<file>: locally changed or unowned content preserved.).
• Tus propios archivos de instrucciones (CLAUDE.md, GEMINI.md, etc.): una instalación interactiva los conserva y avisa; con --yes se copian antes a <file>.bak (numerado si hace falta) y luego se sustituyen por el archivo de BMAD+. Un archivo de BMAD+ que hayas editado siempre se conserva. Los archivos antiguos de BMAD+ sin huellas de propiedad se guardan antes como <file>.bak.
• _bmad/config.yaml se fusiona: las claves existentes ganan, se añaden los valores por defecto que faltan, y las respuestas dadas explícitamente en el asistente (o --mode) sustituyen al valor anterior. Si el archivo no se puede analizar, queda intacto, con un aviso.
• Una versión distinta se rechaza. Usa update: planifica el cambio, hace copias de seguridad y registra un recibo.
• Un manifiesto ilegible se copia antes a _bmad/.bmad-plus-install.json.corrupt.bak (numerado si ya existe) y luego se sustituye.

Códigos de salida#

Salida real#

Esta es la instalación registrada de los packs Core y Design para Claude Code, en francés (--lang fr), de la receta de aceptación humana de la 0.23.0. La línea «5 agents, 9 habilidades, 4 fichiers copiés» cuenta carpetas de agentes, carpetas de habilidades y otros archivos copiados. El recuadro termina con la guía de inicio; sus líneas de ejemplo dependen de los packs elegidos (aquí la línea de Design).

$ npx bmad-plus install --yes --lang fr --packs core,design --tools claude-code --directory .\demo-app
T   BMAD+ Installer v0.23.0
|
•  ✨ Created by Laurent Rochetta — github.com/lrochetta/BMAD-PLUS
|
•  Installation dans: C:\Users\you\demo-app
|
*  Packs sélectionnés: ⚙️ Core, 🎨 Design
|
•  IDE détectés: Claude Code
|
o  ✅ 5 agents, 9 skills, 4 fichiers copiés
|
o  ✅ 1 IDE configuré(s)
|
o  ✅ Installation terminée — Comment commencer -------------------------------+
|                                                                              |
|  💬 À qui parler ?                                                           |
|                                                                              |
|    Discuter d'une idée          →  "Atlas, [...]"                            |
|    Créer un PRD                 →  "Atlas, create PRD"                       |
|    Architecture technique       →  "Forge, propose architecture"             |
|    Implémenter du code          →  "Forge, implement story [X]"              |
|    Tester / code review         →  "Sentinel, review module [X]"             |
|    Planifier un sprint          →  "Nexus, create epics"                     |
|    Tout automatiser             →  "autopilot"                               |
|    Design avec Atelier          →  "/design read"                            |
|                                                                              |
|  📦 Commandes CLI:                                                           |
|    npx bmad-plus install    — Installer agents & skills                      |
|    npx bmad-plus update     — Mettre à jour (conserve la config)             |
|    npx bmad-plus doctor     — Vérifier l'installation                        |
|    npx bmad-plus uninstall  — Supprimer BMAD+ du projet                      |
|                                                                              |
|  💡 Exemples rapides:                                                        |
|    🎨 Design : "/design read" → Atelier vous interroge, puis construit       |
|                                                                              |
+------------------------------------------------------------------------------+
|
—  BMAD+ est prêt ! Parle à Atlas pour commencer 🚀

Errores y qué hacer#

Ejemplos#

npx bmad-plus@0.23.0 install

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

npx bmad-plus install --packs all --tools all --yes

npx bmad-plus install --tools none --yes

npx bmad-plus install --packs seo --provision-python