Files
BMAD-METHOD/docs/installers-bundlers/web-bundler-usage.md
2025-09-28 23:17:07 -05:00

1.4 KiB

Web Bundler Usage

ALPHA NOTE: Bundling of individual agents might work, team bundling is being reworked and will come with Beta release soon.

The web bundler creates self-contained XML bundles for BMAD agents, packaging all dependencies for web deployment.

Quick Start

# Bundle all agents from all modules
npm run bundle

# Clean and rebundle (removes old bundles first)
npm run rebundle

Custom Output Directory

# Bundle to custom directory
node tools/cli/bundlers/bundle-web.js all --output ./my-bundles

# Rebundle to custom directory (auto-cleans first)
node tools/cli/bundlers/bundle-web.js rebundle --output /absolute/path/to/custom/directory

# Bundle specific module to custom directory
node tools/cli/bundlers/bundle-web.js module bmm --output ./custom-folder

# Bundle specific agent to custom directory
node tools/cli/bundlers/bundle-web.js agent bmm analyst -o ./custom-folder

Output

Bundles are generated in web-bundles/ directory by default when run from the root of the clones project:

web-bundles/
├── [module-name]/
│   └── agents/
│       └── [agent-name].xml

Skipping Agents

Agents with bundle="false" attribute are automatically skipped during bundling.

Bundle Contents

Each bundle includes:

  • Agent definition with web activation
  • All resolved dependencies
  • Manifests for agent/team discovery