139 lines
2.7 KiB
Markdown
139 lines
2.7 KiB
Markdown
---
|
|
title: "How to Install BMad"
|
|
description: Step-by-step guide to installing BMad in your project
|
|
---
|
|
|
|
|
|
Complete guide to installing BMad in your project.
|
|
|
|
---
|
|
|
|
## Prerequisites
|
|
|
|
- **Node.js** 20+ (required for the installer)
|
|
- **Git** (recommended)
|
|
- **AI-powered IDE** (Claude Code, Cursor, Windsurf, or similar)
|
|
|
|
---
|
|
|
|
## Steps
|
|
|
|
### 1. Run the Installer
|
|
|
|
```bash
|
|
npx bmad-method install
|
|
```
|
|
|
|
### 2. Choose Installation Location
|
|
|
|
The installer will ask where to install BMad files. Options:
|
|
- Current directory (recommended for new projects)
|
|
- Subdirectory
|
|
- Custom path
|
|
|
|
### 3. Select Your AI Tools
|
|
|
|
Choose which AI tools you'll be using:
|
|
- Claude Code
|
|
- Cursor
|
|
- Windsurf
|
|
- Other
|
|
|
|
The installer configures BMad for your selected tools.
|
|
|
|
### 4. Choose Modules
|
|
|
|
Select which modules to install:
|
|
|
|
| Module | Purpose |
|
|
|--------|---------|
|
|
| **BMM** | Core methodology for software development |
|
|
| **BMGD** | Game development workflows |
|
|
| **CIS** | Creative intelligence and facilitation |
|
|
| **BMB** | Building custom agents and workflows |
|
|
|
|
### 5. Add Custom Content (Optional)
|
|
|
|
If you have custom agents, workflows, or modules:
|
|
- Point to their location
|
|
- The installer will integrate them
|
|
|
|
### 6. Configure Settings
|
|
|
|
For each module, either:
|
|
- Accept recommended defaults (faster)
|
|
- Customize settings (more control)
|
|
|
|
---
|
|
|
|
## Verify Installation
|
|
|
|
After installation, verify by:
|
|
|
|
1. Checking the `_bmad/` directory exists
|
|
2. Loading an agent in your AI tool
|
|
3. Running `*menu` to see available commands
|
|
|
|
---
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
your-project/
|
|
├── _bmad/
|
|
│ ├── bmm/ # Method module
|
|
│ │ ├── agents/ # Agent files
|
|
│ │ ├── workflows/ # Workflow files
|
|
│ │ └── config.yaml # Module config
|
|
│ ├── core/ # Core utilities
|
|
│ └── ...
|
|
├── _bmad-output/ # Generated artifacts
|
|
└── .claude/ # IDE configuration
|
|
```
|
|
|
|
---
|
|
|
|
## Configuration
|
|
|
|
Edit `_bmad/[module]/config.yaml` to customize:
|
|
|
|
```yaml
|
|
output_folder: ./_bmad-output
|
|
user_name: Your Name
|
|
communication_language: english
|
|
```
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### "Command not found: npx"
|
|
|
|
Install Node.js 20+:
|
|
```bash
|
|
brew install node
|
|
|
|
```
|
|
|
|
### "Permission denied"
|
|
|
|
Check npm permissions:
|
|
```bash
|
|
npm config set prefix ~/.npm-global
|
|
```
|
|
|
|
### Installer hangs
|
|
|
|
Try running with verbose output:
|
|
```bash
|
|
npx bmad-method install --verbose
|
|
```
|
|
|
|
---
|
|
|
|
## Related
|
|
|
|
- [Quick Start Guide](/tutorials/getting-started/getting-started-bmadv6/) - Getting started with BMM
|
|
- [Upgrade to V6](/how-to/installation/upgrade-to-v6/) - Upgrading from previous versions
|
|
- [Install Custom Modules](/how-to/installation/install-custom-modules/) - Adding custom content
|