Neinteraktivní instalace

Použijte příznaky příkazové řádky k neinteraktivní instalaci BMad. To je užitečné pro:

Kdy to použít

Automatizovaná nasazení a CI/CD pipelines
Skriptované instalace
Hromadné instalace napříč více projekty
Rychlé instalace se známými konfiguracemi

Dostupné příznaky

Možnosti instalace

Příznak	Popis	Příklad
`--directory <cesta>`	Instalační adresář	`--directory ~/projects/myapp`
`--modules <moduly>`	Čárkou oddělená ID modulů	`--modules bmm,bmb`
`--tools <nástroje>`	Čárkou oddělená ID nástrojů/IDE (použijte `none` pro přeskočení)	`--tools claude-code,cursor` nebo `--tools none`
`--custom-content <cesty>`	Čárkou oddělené cesty k vlastním modulům	`--custom-content ~/my-module,~/another-module`
`--action <typ>`	Akce pro existující instalace: `install` (výchozí), `update` nebo `quick-update`	`--action quick-update`

Základní konfigurace

Příznak	Popis	Výchozí
`--user-name <jméno>`	Jméno, které agenti použijí	Systémové uživatelské jméno
`--communication-language <jazyk>`	Jazyk komunikace agentů	English
`--document-output-language <jazyk>`	Jazyk výstupních dokumentů	English
`--output-folder <cesta>`	Cesta k výstupní složce	_bmad-output

Další možnosti

Příznak	Popis
`-y, --yes`	Přijmout všechna výchozí nastavení a přeskočit výzvy
`-d, --debug`	Povolit ladící výstup pro generování manifestu

ID modulů

Dostupná ID modulů pro příznak --modules:

bmm — BMad Method Master
bmb — BMad Builder

Zkontrolujte registr BMad pro dostupné externí moduly.

ID nástrojů/IDE

Dostupná ID nástrojů pro příznak --tools:

Preferované: claude-code, cursor

Spusťte npx bmad-method install interaktivně jednou pro zobrazení aktuálního seznamu podporovaných nástrojů, nebo zkontrolujte konfiguraci kódů platforem.

Režimy instalace

Režim	Popis	Příklad
Plně neinteraktivní	Zadejte všechny příznaky pro přeskočení výzev	`npx bmad-method install --directory . --modules bmm --tools claude-code --yes`
Polo-interaktivní	Zadejte některé příznaky; BMad se zeptá na zbytek	`npx bmad-method install --directory . --modules bmm`
Pouze výchozí	Přijměte vše výchozí s `-y`	`npx bmad-method install --yes`
Bez nástrojů	Přeskočte konfiguraci nástrojů/IDE	`npx bmad-method install --modules bmm --tools none`

Příklady

Instalace v CI/CD pipeline

#!/bin/bash
npx bmad-method install \
  --directory "${GITHUB_WORKSPACE}" \
  --modules bmm \
  --tools claude-code \
  --user-name "CI Bot" \
  --communication-language English \
  --document-output-language English \
  --output-folder _bmad-output \
  --yes

Aktualizace existující instalace

npx bmad-method install \
  --directory ~/projects/myapp \
  --action update \
  --modules bmm,bmb,custom-module

Rychlá aktualizace (zachování nastavení)

npx bmad-method install \
  --directory ~/projects/myapp \
  --action quick-update

Instalace s vlastním obsahem

npx bmad-method install \
  --directory ~/projects/myapp \
  --modules bmm \
  --custom-content ~/my-custom-module,~/another-module \
  --tools claude-code

Co získáte

Plně nakonfigurovaný adresář _bmad/ ve vašem projektu
Agenty a workflow nakonfigurované pro vybrané moduly a nástroje
Složku _bmad-output/ pro generované artefakty

Validace a zpracování chyb

BMad validuje všechny zadané příznaky:

Adresář — Musí být platná cesta s oprávněním k zápisu
Moduly — Upozorní na neplatná ID modulů (ale nespadne)
Nástroje — Upozorní na neplatná ID nástrojů (ale nespadne)
Vlastní obsah — Každá cesta musí obsahovat platný soubor module.yaml
Akce — Musí být jedna z: install, update, quick-update

Neplatné hodnoty buď:

Zobrazí chybu a ukončí se (pro kritické možnosti jako adresář)
Zobrazí varování a přeskočí (pro volitelné položky jako vlastní obsah)
Přepnou na interaktivní výzvy (pro chybějící povinné hodnoty)

Řešení problémů

Instalace selže s „Invalid directory“

Cesta k adresáři musí existovat (nebo musí existovat jeho nadřazený adresář)
Potřebujete oprávnění k zápisu
Cesta musí být absolutní nebo správně relativní k aktuálnímu adresáři

Modul nenalezen

Ověřte, že ID modulu je správné
Externí moduly musí být dostupné v registru

Neplatná cesta k vlastnímu obsahu

Ujistěte se, že každá cesta k vlastnímu obsahu:

Ukazuje na adresář
Obsahuje soubor module.yaml v kořeni
Má pole code v module.yaml