Bulwark|Docs

bulwark install

Register Bulwark as a hook provider for your coding tool.

Synopsis

bulwark install [flags]

Description

The install command modifies your coding tool's configuration to route all tool calls through Bulwark. This enables policy enforcement and the approval workflow.

By default, bulwark install auto-detects which coding tools are installed on your system and configures hooks for all of them. Use the --claude or --amp flags to target a specific tool.

After installation, every tool call from the coding tool will:

  1. Be sent to Bulwark for policy evaluation
  2. Either auto-approve, auto-deny, or wait for manual approval
  3. Return the decision to the coding tool

Flags

FlagDescription
--claudeInstall hooks for Claude Code only
--ampInstall hooks for Amp only
--localInstall to project-level settings instead of user-level

When neither --claude nor --amp is specified, Bulwark auto-detects installed tools and configures all of them.

Example

# Auto-detect and install for all available tools
$ bulwark install
✓ Bulwark hooks installed for Claude Code
✓ Bulwark hooks installed for Amp

# Install for Claude Code only
$ bulwark install --claude
✓ Bulwark hooks installed for Claude Code

# Install for Amp only
$ bulwark install --amp
✓ Bulwark hooks installed for Amp

What It Does

Claude Code

The install command adds Bulwark to your Claude Code hooks configuration at:

  • macOS/Linux: ~/.claude/settings.json
  • Windows: %USERPROFILE%\.claude\settings.json

Prerequisites

  • You must be logged in (bulwark login)
  • At least one supported coding tool must be installed

Verification

After installing, start a session:

Claude Code:

claude "hello"

Amp:

amp "hello"

Tool calls should now appear in your Bulwark dashboard.

See Also