{"id":50734701,"url":"https://github.com/najibninaba/bmad-pack-installer","last_synced_at":"2026-06-10T12:30:49.588Z","repository":{"id":309812432,"uuid":"1037451185","full_name":"najibninaba/bmad-pack-installer","owner":"najibninaba","description":"Installer for BMAD expansion packs with automated deployment, symbolic link management, and manifest   handling","archived":false,"fork":false,"pushed_at":"2025-08-14T14:36:24.000Z","size":87,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-03T21:50:00.290Z","etag":null,"topics":["bmad","bmad-method"],"latest_commit_sha":null,"homepage":"https://github.com/najibninaba/bmad-pack-installer","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/najibninaba.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-13T15:36:28.000Z","updated_at":"2025-11-14T18:14:13.000Z","dependencies_parsed_at":"2025-08-14T00:23:05.135Z","dependency_job_id":"db8b83a1-f88a-4e0b-a10a-bede0fefbd29","html_url":"https://github.com/najibninaba/bmad-pack-installer","commit_stats":null,"previous_names":["najibninaba/bmad-pack-installer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/najibninaba/bmad-pack-installer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/najibninaba%2Fbmad-pack-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/najibninaba%2Fbmad-pack-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/najibninaba%2Fbmad-pack-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/najibninaba%2Fbmad-pack-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/najibninaba","download_url":"https://codeload.github.com/najibninaba/bmad-pack-installer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/najibninaba%2Fbmad-pack-installer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34153482,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bmad","bmad-method"],"created_at":"2026-06-10T12:30:48.960Z","updated_at":"2026-06-10T12:30:49.569Z","avatar_url":"https://github.com/najibninaba.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BMAD Expansion Pack Installer\n\nA modern Python tool for installing BMAD (Breakthrough Method for Agile Ai Driven Development) expansion packs with proper directory structure, symbolic links, and manifest management.\n\n## Features\n\n- Installs BMAD expansion packs with proper directory structure\n- Creates symbolic links for Claude Code integration\n- Generates hidden directories using `.bmad-pack-name` format\n- Provides SHA-256 hash generation and verification\n- Creates and updates installation manifests\n- Excludes development files and directories automatically\n- Supports Windows, macOS, and Linux\n- Displays progress indicators during installation\n- Validates source packs and target projects\n\n## Installation\n\n### Recommended: Install as Tool\n\n```bash\n# Install once (recommended for regular use)\nuv tool install bmad-pack-installer\n\n# Use anywhere - command available globally\nbmad-pack-installer --version\nbmad-pack-installer deploy ./expansion-pack-source ./target-project\n```\n\n### Quick Use Without Installation\n\n```bash\n# Run directly with uvx (no installation needed)\nuvx --from bmad-pack-installer bmad-pack-installer deploy ./expansion-pack-source ./target-project\n```\n\n### Install in Project\n\n```bash\n# Add to current project dependencies\nuv add bmad-pack-installer\n\n# Or install with pip\npip install bmad-pack-installer\n\n# Use in project context\nuv run bmad-pack-installer deploy ./expansion-pack-source ./target-project\n```\n\n### Install from Source (Development)\n\n```bash\n# Clone the repository\ngit clone https://github.com/najibninaba/bmad-pack-installer.git\ncd bmad-pack-installer\n\n# Install in virtual environment with uv\nuv venv .venv\nsource .venv/bin/activate  # On Windows: .venv\\Scripts\\activate\nuv pip install -e .\n\n# Install in virtual environment with pip\npython -m venv .venv\nsource .venv/bin/activate  # On Windows: .venv\\Scripts\\activate\npip install -e .\n```\n\n## Updating\n\nTo upgrade to the latest version:\n\n```bash\n# If installed as a tool (recommended)\nuv tool upgrade bmad-pack-installer\n\n# If installed with pip\npip install --upgrade bmad-pack-installer\n\n# If installed in a project with uv\nuv add --upgrade bmad-pack-installer\n\n# Check current version\nbmad-pack-installer --version\n```\n\n## Usage\n\n### Basic Deployment\n\n```bash\n# Deploy expansion pack to BMAD project (assumes tool installation)\nbmad-pack-installer deploy ./bmad-aisg-aiml /path/to/project\n```\n\n### Advanced Options\n\n```bash\n# Custom pack and command names\nbmad-pack-installer deploy ./source /target \\\n  --pack-name=ai-ml-engineering \\\n  --command-name=bmadAISG\n\n# Dry run to preview changes\nbmad-pack-installer deploy ./source /target --dry-run\n\n# Force reinstall over existing pack\nbmad-pack-installer deploy ./source /target --force\n\n# Skip certain installation steps\nbmad-pack-installer deploy ./source /target \\\n  --skip-core-update \\\n  --skip-symlinks\n\n# Configure for different IDE\nbmad-pack-installer deploy ./source /target --ide=cursor\n```\n\n### Validation Commands\n\n```bash\n# Check if directory is a valid BMAD project\nbmad-pack-installer check /path/to/project\n\n# Validate expansion pack structure\nbmad-pack-installer validate ./expansion-pack\n```\n\n\u003e **Note:** If you haven't installed as a tool, prefix commands with `uvx --from bmad-pack-installer` or use `uv run bmad-pack-installer` if installed in a project.\n\n## Command Line Options\n\n| Option | Description |\n|--------|-------------|\n| `--pack-name` | Override pack name (auto-prepends 'bmad-' if missing) |\n| `--command-name` | Claude command name (default: from config.yaml) |\n| `--ide` | IDE to configure: claude-code, cursor, windsurf |\n| `--skip-core-update` | Skip updating .bmad-core/install-manifest.yaml |\n| `--skip-symlinks` | Skip creating symbolic links |\n| `--force` | Overwrite existing installation |\n| `--dry-run` | Show what would be installed without changes |\n| `--verbose` | Enable detailed logging |\n\n## Expansion Pack Requirements\n\nYour expansion pack must have this structure:\n\n```\nbmad-expansion-pack/\n├── config.yaml                 # Required: Pack metadata\n├── agents/                     # AI agent definitions\n│   └── *.md\n├── tasks/                      # Task definitions  \n│   └── *.md\n├── templates/                  # Document templates\n│   └── *.yaml\n├── checklists/                 # Validation checklists\n│   └── *.md\n├── workflows/                  # Multi-step workflows\n│   └── *.yaml\n├── agent-teams/               # Agent team configurations\n│   └── *.yaml\n├── data/                      # Reference data\n│   └── *.md\n└── web-bundles/              # Pre-built UI bundles\n    └── *.txt\n```\n\n### Required config.yaml\n\n```yaml\nname: expansion-pack-name        # Will get 'bmad-' prefix\nversion: 1.0.0                   # Semantic version\ndescription: Pack description    # Human-readable description\nslashPrefix: commandName         # Claude command name (optional)\n```\n\n## Deployment Process\n\nThe installer performs these steps:\n\n1. Validates source pack and target project\n2. Copies files to hidden `.bmad-pack-name/` directory\n3. Generates SHA-256 hashes for integrity checking\n4. Creates installation manifests\n5. Updates `.bmad-core/install-manifest.yaml`\n6. Creates symbolic links in `.claude/commands/`\n\n\n## Examples\n\n### Deploying the AI/ML Engineering Pack\n\n```bash\n# Basic deployment\nbmad-pack-installer deploy ./bmad-aisg-aiml ./my-project\n\n# Results in:\n# - Hidden directory: ./my-project/.bmad-aisg-aiml/\n# - Claude commands: ./my-project/.claude/commands/bmadAISG/\n# - Updated manifests and symlinks\n```\n\n### Dry Run Preview\n\n```bash\nbmad-pack-installer deploy ./pack ./project --dry-run\n\n# Output:\n# DRY RUN: Would deploy expansion pack 'bmad-pack-name'\n# Target directory: .bmad-pack-name\n# Files to deploy: 47\n# Potential symlinks: 12\n# Command name: packCommand\n```\n\n## Target Project Requirements\n\nThe target project must be BMAD-enabled with:\n\n- `.bmad-core/` directory\n- `.bmad-core/install-manifest.yaml` file\n\n## Development\n\nTo develop or contribute to this tool:\n\n```bash\n# Clone and setup\ngit clone \u003crepository\u003e\ncd bmad-pack-installer\n\n# Install in development mode\nuv pip install -e .\n\n# Run tests\nuv run pytest\n\n# Format code\nuv run black src/\nuv run flake8 src/\n```\n\n## Troubleshooting\n\n### Pack Not Recognized\n\n- Ensure `config.yaml` exists in source directory\n- Verify required fields: `name`, `version`\n\n### Target Not Valid BMAD Project\n\n- Check for `.bmad-core/` directory\n- Verify `.bmad-core/install-manifest.yaml` exists\n\n### Symlink Creation Failed\n\n- On Windows: Run as Administrator or enable Developer Mode\n- Fallback: Files are copied instead of symlinked\n\n### Permission Errors\n\n- Check write permissions to target directory\n- Ensure `.bmad-core/install-manifest.yaml` is writable\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Support\n\nFor issues and feature requests, please visit the [GitHub repository](https://github.com/najibninaba/bmad-pack-installer).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnajibninaba%2Fbmad-pack-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnajibninaba%2Fbmad-pack-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnajibninaba%2Fbmad-pack-installer/lists"}