2.6 KiB

Raw Blame History

Claude Code Hooks Installation Solution

Problem

Users who download BMAD-Method need a way to install Claude Code hooks that:

Works regardless of where they install BMAD
Doesn't require global installation paths
Integrates seamlessly with existing BMAD projects

Solution

The installer now copies hook files directly into the project's .bmad-core directory and configures project-level Claude Code settings.

How It Works

Hook files are copied to the project
- Source: BMAD-METHOD-main/tools/claude-code-hooks/
- Target: <project>/.bmad-core/hooks/claude-code/
- Includes all hook files and the lib directory
Project-level settings are created
- Creates/updates <project>/.claude/settings.json
- Uses relative paths from project root
- Preserves existing non-BMAD settings

Installation command

# From BMAD source directory
cd /path/to/BMAD-METHOD-main
npm run install:claude-hooks -- --project-dir /path/to/your/project

Benefits

Portable: Hook files travel with the project
No global paths: Everything is relative to the project
Version control friendly: Hooks can be committed with the project
Multiple projects: Each project has its own hook configuration
Easy updates: Just re-run the installer to update hooks

For End Users

When BMAD-Method is merged upstream:

Clone/download BMAD-Method
Install BMAD in their project normally
Run the Claude Code hooks installer pointing to their project
Important: If VS Code is already open, close and restart it
Start using Claude Code with automatic BMAD integration

Activation Methods

After installation, the hooks will activate automatically when using Claude Code:

Method 1: Open VS Code First (GUI)

Open VS Code normally
Open your project folder (File → Open Folder)
Use Claude Code - hooks are automatically active

Method 2: Terminal Launch

Navigate to your project: cd /path/to/your/project
Launch: claude code .
Hooks are automatically active

Note: Both methods work equally well. The key is that Claude Code loads .claude/settings.json from your project root, regardless of how you launch it.

Restart Requirement

⚠️ If VS Code was already open during installation:

You MUST close and restart VS Code
Claude Code loads settings on initialization
Changes to .claude/settings.json require a restart to take effect

Future Enhancement (PR8)

In PR8, we'll integrate this directly into the main BMAD installer menu, so users can select "Install Claude Code Hooks" as an option during normal installation.

2.6 KiB Raw Blame History