Quick Start
This guide walks you through setting up Bulwark and creating your first policy.
1. Install and Authenticate
If you haven't already, install Bulwark and log in:
brew install bulwark
bulwark login
bulwark install
2. Create Your First Policy
Go to Settings → Policies in your dashboard and click Add Policy.
Let's create a policy that requires approval before deleting files:
| Field | Value |
|---|---|
| Name | Protect deletions |
| Description | Ask before deleting files or directories |
| Action | Ask |
| Status | Active |
Add a Rule
Click Add Rule and configure:
- Field:
tool_name - Operator:
equals - Value:
Bash
Click Add Rule again:
- Field:
tool_input.command - Operator:
contains - Value:
rm
Set the combinator to AND so both conditions must match.
Save your policy.
3. Test It Out
Start a Claude Code session and ask it to delete something:
claude "delete the file test.txt"
You should see the agent pause and a notification appear in your Bulwark dashboard.
4. Approve or Deny
Open your dashboard to see the pending request. You'll see:
- The command Claude wants to run
- Which policy triggered the approval requirement
- Session context
Click Approve to allow the action or Deny to block it.
What's Next?
You now have Bulwark protecting your agent sessions! Here are some next steps:
- Create more policies for different scenarios
- Learn about rule conditions for precise matching
- Explore CLI commands for advanced usage
Tip
Start with broad policies and refine them as you learn what your agents typically do. You can always make policies more specific later.