Faults CLI reference

The faults command lets you view and manage faults (errors) in your projects.

All faults commands require --project-id.

List faults

hb faults list --project-id 12345

With search and ordering

# Search for specific error classes
hb faults list --project-id 12345 --query "class:RuntimeError"

# Sort by frequency instead of recency
hb faults list --project-id 12345 --order frequent

# Limit results
hb faults list --project-id 12345 --limit 10

Required flags:

• --project-id — Project ID

Optional flags:

• -q, --query — Search query string
• --order — Sort order: recent or frequent (default: recent)
• --limit — Maximum results (default: 25, max: 25)
• -o, --output — Output format: table or json (default: table)

Get fault details

hb faults get --project-id 12345 --id 67890

Required flags:

• --project-id — Project ID
• --id — Fault ID

Optional flags:

• -o, --output — Output format: text or json (default: text)

List notices for a fault

View individual error occurrences for a fault:

hb faults notices --project-id 12345 --id 67890
hb faults notices --project-id 12345 --id 67890 --limit 10

Required flags:

• --project-id — Project ID
• --id — Fault ID

Optional flags:

• --limit — Maximum results (default: 25, max: 25)
• -o, --output — Output format: table or json (default: table)

Get fault counts

Get aggregated fault counts for a project:

hb faults counts --project-id 12345

Required flags:

• --project-id — Project ID

Optional flags:

• -o, --output — Output format: text or json (default: text)

List affected users

View users affected by a specific fault:

hb faults affected-users --project-id 12345 --id 67890

# Search for a specific user
hb faults affected-users --project-id 12345 --id 67890 --query "user@example.com"

Required flags:

• --project-id — Project ID
• --id — Fault ID

Optional flags:

• -q, --query — Search query to filter users
• -o, --output — Output format: table or json (default: table)