Projects

Projects represent AI agents under test. Each project contains configuration, scope definitions, and associated test experiments.

List Projects

hb projects list

Set Active Project

hb projects use <id>

Show Project Details

# Show current project
hb projects show

# Show specific project
hb projects show <id>

# Alternative: show active project
hb projects current

Update Project

# Update current project
hb projects update --name "New Name"

# Update specific project
hb projects update <id> --description "Updated description"

Delete Project

# Delete with confirmation
hb projects delete <id>

# Skip confirmation
hb projects delete <id> --force

Project Status

Check if anything is running on the project — experiments, campaigns, monitoring state.

# One-shot status check
hb projects status

# Watch mode — polls every 3 minutes until idle
hb projects status -w

Shows: active/idle state, running experiments, posture grade, monitoring status, active campaign.

Generate Project Report

# Generate HTML report (opens in browser by default)
hb projects report

# Save to file
hb projects report -o report.html

# Save without opening browser
hb projects report -o report.html --no-open

Warning

Deleting a project will also delete all associated experiments, logs, and findings. This action cannot be undone.