Back to Beads

bd status

website/versioned_docs/version-1.0.0/cli-reference/status.md

1.0.41.2 KB
Original Source
<!-- AUTO-GENERATED: do not edit manually -->

Generated from bd help --doc status

bd status

Show a quick snapshot of the issue database state and statistics.

This command provides a summary of issue counts by state (open, in_progress, blocked, closed), ready work, extended statistics (pinned issues, average lead time), and recent activity over the last 24 hours from git history.

Similar to how 'git status' shows working tree state, 'bd status' gives you a quick overview of your issue database without needing multiple queries.

Use cases:

  • Quick project health check
  • Onboarding for new contributors
  • Integration with shell prompts or CI/CD
  • Daily standup reference

Examples: bd status # Show summary with activity bd status --no-activity # Skip git activity (faster) bd status --json # JSON format output bd status --assigned # Show issues assigned to current user bd stats # Alias for bd status

bd status [flags]

Aliases: stats

Flags:

      --all           Show all issues (default behavior)
      --assigned      Show issues assigned to current user
      --no-activity   Skip git activity tracking (faster)