using-beads-bvlisted

# Using Beads and bv ## Overview Beads provides a lightweight, dependency-aware issue database. The `bd` CLI manages tasks, while `bv` provides graph metrics and execution planning. **Project:** [steveyegge/beads](https://github.com/steveyegge/beads) ## When to Use - Coordinating multi-agent work with dependencies - Finding ready work (no blockers) - Priority management and task sequencing - Understanding project graph metrics **Don't use:** Simple single-session tasks (use TodoWrite instead). ## Quick Reference | Command | Description | |---------|-------------| | `bd ready` | Show issues ready to work (no blockers) | | `bd list --status=open` | All open issues | | `bd list --status=in_progress` | Active work | | `bd show <id>` | Issue details with dependencies | | `bd create --title="..." --type=task` | Create new issue | | `bd update <id> --status=in_progress` | Claim work | | `bd close <id>` | Mark complete | ## bv Robot Flags (AI Sidecar) **CRITICAL:** Always use `--robot-*` flags. The interactive TUI will block your session! ```bash bv --robot-help # All AI-facing commands bv --robot-insights # JSON graph metrics (PageRank, critical path, cycles) bv --robot-plan # JSON execution plan with parallel tracks bv --robot-priority # Priority recommendations with reasoning bv --robot-recipes # List available recipes bv --robot-diff --diff-since <commit> # Changes since commit/date ``` ### Example: Get Execution Plan ```bash bv --r