beads-viewer
Graph analysis with bv (Beads Viewer). Use when analyzing the task graph, finding blockers, getting recommendations, checking critical path, or when the user mentions "bv", "graph", "dependencies", or "what should I work on".
Security Assessment
About beads-viewer
Beads Viewer (bv) is a powerful graph analysis tool that enhances task management by analyzing the task graph in Beads. It provides deep insights into dependencies, blockers, and overall task flow, helping users optimize their work. By precomputing key metrics like PageRank, Betweenness, and Critical Path, it allows users to identify foundational blockers, bottlenecks, and the longest chains of dependencies. This tool is indispensable for users needing to analyze complex project graphs and find the most efficient paths forward, making sure that critical tasks are prioritized and blockers are addressed promptly.
FAQ
How do I use Beads Viewer for task analysis?
To use Beads Viewer, simply run commands with the `--robot-*` flags. For example, `bv --robot-next` provides the best next task, while `bv --robot-triage` gives a full triage with blockers and quick wins.
Can Beads Viewer handle multi-agent partitioning?
Yes, Beads Viewer supports multi-agent partitioning with the `--robot-triage-by-track` flag. This helps in splitting tasks across parallel tracks and provides detailed information on dependencies and unblocked tasks.
Are there any restrictions when using Beads Viewer?
You should never run Beads Viewer without the `--robot-*` flags, as running bare `bv` launches a TUI that can hang AI agents. Additionally, it's recommended to use the `--robot-alerts` command to catch stale issues before starting large tasks.
What kind of metrics does Beads Viewer provide?
Beads Viewer calculates key graph metrics such as PageRank (for foundational blockers), Betweenness (for bottlenecks), and Critical Path (for the longest dependency chain) to help prioritize tasks and uncover blockers.
Install beads-viewer
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
Mburdo/knowledge_and_vibes