beadboard/help/cli/bd-branch-help.txt

List all branches or create a new branch.

This command requires the Dolt storage backend. Without arguments,
it lists all branches. With an argument, it creates a new branch.

Examples:
  bd branch                    # List all branches
  bd branch feature-xyz        # Create a new branch named feature-xyz

Usage:
  bd branch [name] [flags]

Flags:
  -h, --help   help for branch

Global Flags:
      --actor string              Actor name for audit trail (default: $BD_ACTOR, git user.name, $USER)
      --allow-stale               Allow operations on potentially stale data (skip staleness check)
      --db string                 Database path (default: auto-discover .beads/*.db)
      --dolt-auto-commit string   Dolt backend: auto-commit after write commands (off|on). Default from config key dolt.auto-commit
      --json                      Output in JSON format
      --lock-timeout duration     SQLite busy timeout (0 = fail immediately if locked) (default 30s)
      --no-auto-flush             Disable automatic JSONL sync after CRUD operations
      --no-auto-import            Disable automatic JSONL import when newer than DB
      --no-daemon                 Force direct storage mode, bypass daemon if running
      --no-db                     Use no-db mode: load from JSONL, no SQLite
      --profile                   Generate CPU profile for performance analysis
  -q, --quiet                     Suppress non-essential output (errors only)
      --readonly                  Read-only mode: block write operations (for worker sandboxes)
      --sandbox                   Sandbox mode: disables daemon and auto-sync
  -v, --verbose                   Enable verbose/debug output