#!/usr/bin/env node const { program } = require('commander'); const path = require('path'); const fs = require('fs').promises; const yaml = require('js-yaml'); // Dynamic imports for ES modules let chalk, inquirer; // Initialize ES modules async function initializeModules() { if (!chalk) { chalk = (await import('chalk')).default; inquirer = (await import('inquirer')).default; } } // Handle both execution contexts (from root via npx or from installer directory) let version; let installer; try { // Try installer context first (when run from tools/installer/) version = require('../package.json').version; installer = require('../lib/installer'); } catch (e) { // Fall back to root context (when run via npx from GitHub) console.log(`Installer context not found (${e.message}), trying root context...`); try { version = require('../../../package.json').version; installer = require('../../../tools/installer/lib/installer'); } catch (e2) { console.error('Error: Could not load required modules. Please ensure you are running from the correct directory.'); console.error('Debug info:', { __dirname, cwd: process.cwd(), error: e2.message }); process.exit(1); } } program .version(version) .description('BMad Method installer - Universal AI agent framework for any domain'); program .command('install') .description('Install BMad Method agents and tools') .option('-f, --full', 'Install complete BMad Method') .option('-x, --expansion-only', 'Install only expansion packs (no bmad-core)') .option('-d, --directory ', 'Installation directory') .option('-i, --ide ', 'Configure for specific IDE(s) - can specify multiple (cursor, claude-code, windsurf, trae, roo, cline, gemini, github-copilot, other)') .option('-e, --expansion-packs ', 'Install specific expansion packs (can specify multiple)') .action(async (options) => { try { await initializeModules(); if (!options.full && !options.expansionOnly) { // Interactive mode const answers = await promptInstallation(); if (!answers._alreadyInstalled) { await installer.install(answers); } } else { // Direct mode let installType = 'full'; if (options.expansionOnly) installType = 'expansion-only'; const config = { installType, directory: options.directory || '.', ides: (options.ide || []).filter(ide => ide !== 'other'), expansionPacks: options.expansionPacks || [] }; await installer.install(config); } } catch (error) { if (!chalk) await initializeModules(); console.error(chalk.red('Installation failed:'), error.message); process.exit(1); } }); program .command('update') .description('Update existing BMad installation') .option('--force', 'Force update, overwriting modified files') .option('--dry-run', 'Show what would be updated without making changes') .action(async () => { try { await installer.update(); } catch (error) { if (!chalk) await initializeModules(); console.error(chalk.red('Update failed:'), error.message); process.exit(1); } }); program .command('list:expansions') .description('List available expansion packs') .action(async () => { try { await installer.listExpansionPacks(); } catch (error) { if (!chalk) await initializeModules(); console.error(chalk.red('Error:'), error.message); process.exit(1); } }); program .command('status') .description('Show installation status') .action(async () => { try { await installer.showStatus(); } catch (error) { if (!chalk) await initializeModules(); console.error(chalk.red('Error:'), error.message); process.exit(1); } }); async function promptInstallation() { await initializeModules(); console.log(chalk.bold.blue(`\nWelcome to BMad Method Installer v${version}\n`)); const answers = {}; // Ask for installation directory first const { directory } = await inquirer.prompt([ { type: 'input', name: 'directory', message: 'Enter the full path to your project directory where BMad should be installed:', validate: (input) => { if (!input.trim()) { return 'Please enter a valid project path'; } return true; } } ]); answers.directory = directory; // Detect existing installations const installDir = path.resolve(directory); const state = await installer.detectInstallationState(installDir); // Check for existing expansion packs const existingExpansionPacks = state.expansionPacks || {}; // Get available expansion packs const availableExpansionPacks = await installer.getAvailableExpansionPacks(); // Build choices list const choices = []; // Load core config to get short-title const coreConfigPath = path.join(__dirname, '..', '..', '..', 'bmad-core', 'core-config.yaml'); const coreConfig = yaml.load(await fs.readFile(coreConfigPath, 'utf8')); const coreShortTitle = coreConfig['short-title'] || 'BMad Agile Core System'; // Add BMad core option let bmadOptionText; if (state.type === 'v4_existing') { const currentVersion = state.manifest?.version || 'unknown'; const newVersion = coreConfig.version || 'unknown'; // Use version from core-config.yaml const versionInfo = currentVersion === newVersion ? `(v${currentVersion} - reinstall)` : `(v${currentVersion} → v${newVersion})`; bmadOptionText = `Update ${coreShortTitle} ${versionInfo} .bmad-core`; } else { bmadOptionText = `Install ${coreShortTitle} (v${coreConfig.version || version}) .bmad-core`; } choices.push({ name: bmadOptionText, value: 'bmad-core', checked: true }); // Add expansion pack options for (const pack of availableExpansionPacks) { const existing = existingExpansionPacks[pack.id]; let packOptionText; if (existing) { const currentVersion = existing.manifest?.version || 'unknown'; const newVersion = pack.version; const versionInfo = currentVersion === newVersion ? `(v${currentVersion} - reinstall)` : `(v${currentVersion} → v${newVersion})`; packOptionText = `Update ${pack.description} ${versionInfo} .${pack.id}`; } else { packOptionText = `Install ${pack.description} (v${pack.version}) .${pack.id}`; } choices.push({ name: packOptionText, value: pack.id, checked: false }); } // Ask what to install const { selectedItems } = await inquirer.prompt([ { type: 'checkbox', name: 'selectedItems', message: 'Select what to install/update (use space to select, enter to continue):', choices: choices, validate: (selected) => { if (selected.length === 0) { return 'Please select at least one item to install'; } return true; } } ]); // Process selections answers.installType = selectedItems.includes('bmad-core') ? 'full' : 'expansion-only'; answers.expansionPacks = selectedItems.filter(item => item !== 'bmad-core'); // Ask for IDE configuration const { ides } = await inquirer.prompt([ { type: 'checkbox', name: 'ides', message: 'Which IDE(s) are you using? (press Enter to skip IDE setup, or select any to configure):', choices: [ { name: 'Cursor', value: 'cursor' }, { name: 'Claude Code', value: 'claude-code' }, { name: 'Windsurf', value: 'windsurf' }, { name: 'Trae', value: 'trae' }, // { name: 'Trae', value: 'trae'} { name: 'Roo Code', value: 'roo' }, { name: 'Cline', value: 'cline' }, { name: 'Gemini CLI', value: 'gemini' }, { name: 'Github Copilot', value: 'github-copilot' } ] } ]); // Use selected IDEs directly answers.ides = ides; // Ask for web bundles installation const { includeWebBundles } = await inquirer.prompt([ { type: 'confirm', name: 'includeWebBundles', message: 'Would you like to include pre-built web bundles? (standalone files for ChatGPT, Claude, Gemini)', default: false } ]); if (includeWebBundles) { console.log(chalk.cyan('\nšŸ“¦ Web bundles are standalone files perfect for web AI platforms.')); console.log(chalk.dim(' You can choose different teams/agents than your IDE installation.\n')); const { webBundleType } = await inquirer.prompt([ { type: 'list', name: 'webBundleType', message: 'What web bundles would you like to include?', choices: [ { name: 'All available bundles (agents, teams, expansion packs)', value: 'all' }, { name: 'Specific teams only', value: 'teams' }, { name: 'Individual agents only', value: 'agents' }, { name: 'Custom selection', value: 'custom' } ] } ]); answers.webBundleType = webBundleType; // If specific teams, let them choose which teams if (webBundleType === 'teams' || webBundleType === 'custom') { const teams = await installer.getAvailableTeams(); const { selectedTeams } = await inquirer.prompt([ { type: 'checkbox', name: 'selectedTeams', message: 'Select team bundles to include:', choices: teams.map(t => ({ name: `${t.icon || 'šŸ“‹'} ${t.name}: ${t.description}`, value: t.id, checked: webBundleType === 'teams' // Check all if teams-only mode })), validate: (answer) => { if (answer.length < 1) { return 'You must select at least one team.'; } return true; } } ]); answers.selectedWebBundleTeams = selectedTeams; } // If custom selection, also ask about individual agents if (webBundleType === 'custom') { const { includeIndividualAgents } = await inquirer.prompt([ { type: 'confirm', name: 'includeIndividualAgents', message: 'Also include individual agent bundles?', default: true } ]); answers.includeIndividualAgents = includeIndividualAgents; } const { webBundlesDirectory } = await inquirer.prompt([ { type: 'input', name: 'webBundlesDirectory', message: 'Enter directory for web bundles:', default: `${answers.directory}/web-bundles`, validate: (input) => { if (!input.trim()) { return 'Please enter a valid directory path'; } return true; } } ]); answers.webBundlesDirectory = webBundlesDirectory; } answers.includeWebBundles = includeWebBundles; return answers; } program.parse(process.argv); // Show help if no command provided if (!process.argv.slice(2).length) { program.outputHelp(); }