Skip to content

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"

# Set the agent's capability surface
hb projects update --capabilities tools=on,memory=off
hb projects update --capabilities all=off,tools=on,reasoning_model=on

--capabilities flag

Declares which agentic features the project uses, so the platform can target the right test categories. Accepts comma-separated key=value pairs.

  • Keys: tools, memory, inter_agent, reasoning_model, plus the shorthand all which sets every key in one step.
  • Values: on / off, true / false, 1 / 0, yes / no (case-insensitive). Bare keys (e.g. tools) imply on.
  • Order matters: pairs apply left-to-right, so all=off,tools=on resets the set and then enables tools.

Updating capabilities archives the project's existing datasets (so the test coverage plan is regenerated). A confirm prompt is shown unless --yes / -y is passed.

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.