BMAD-METHOD/tools/installer
Alex Verkhovsky 9c6534259d refactor(cli): rename tools/cli to tools/installer and flatten lib directories
The entire CLI exists to serve the installer. Rename the directory to
reflect its purpose and collapse the two redundant lib/ directories
(cli/lib/ and cli/installers/lib/) into the top level.

- tools/cli/ -> tools/installer/
- tools/installer/installers/lib/{core,ide,modules}/ -> tools/installer/{core,ide,modules}/
- tools/installer/lib/*.js -> tools/installer/*.js
- Update all require() paths, package.json bin/main, CI workflow, tests, and docs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-22 10:46:50 -06:00
..
commands refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
core refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
ide refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
modules refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
README.md refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
bmad-cli.js refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
cli-utils.js refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
custom-handler.js refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
external-official-modules.yaml refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
file-ops.js refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
install-messages.yaml refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
message-loader.js refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
project-root.js refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
prompts.js refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
ui.js refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00
yaml-format.js refactor(cli): rename tools/cli to tools/installer and flatten lib directories 2026-03-22 10:46:50 -06:00

README.md

BMad CLI Tool

Installing external repo BMad official modules

For external official modules to be discoverable during install, ensure an entry for the external repo is added to external-official-modules.yaml.

For community modules - this will be handled in a different way. This file is only for registration of modules under the bmad-code-org.

Post-Install Notes

Modules can display setup guidance to users after configuration is collected during npx bmad-method install. Notes are defined in the module's own module.yaml — no changes to the installer are needed.

Simple Format

Always displayed after the module is configured:

post-install-notes: |
  Thank you for choosing the XYZ Cool Module
  For Support about this Module call 555-1212  

Conditional Format

Display different messages based on a config question's answer:

post-install-notes:
  config_key_name:
    value1: |
      Instructions for value1...      
    value2: |
      Instructions for value2...      

Values without an entry (e.g., none) display nothing. Multiple config keys can each have their own conditional notes.

Example: TEA Module

The TEA module uses the conditional format keyed on tea_browser_automation:

post-install-notes:
  tea_browser_automation:
    cli: |
      Playwright CLI Setup:
        npm install -g @playwright/cli@latest
        playwright-cli install --skills      
    mcp: |
      Playwright MCP Setup (two servers):
        1. playwright    — npx @playwright/mcp@latest
        2. playwright-test — npx playwright run-test-mcp-server      
    auto: |
      Playwright CLI Setup:
        ...
      Playwright MCP Setup (two servers):
        ...      

When a user selects auto, they see both CLI and MCP instructions. When they select none, nothing is shown.