Projects

A Humanbound project represents one AI agent under test — its scope definition, endpoint configuration, and the full history of experiments, findings, and posture scores produced against it. The hb projects commands list and switch between projects, show project details and current status (running experiments, posture grade, monitoring state), update name or description, generate HTML reports, and delete a project along with all its associated experiments, logs, and findings.

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.