bv
Beads Viewer - graph-aware triage engine for Beads issue tracker with 9 graph metrics (PageRank, betweenness, HITS, etc.), dependency-aware planning, and purpose-built robot protocol for AI agents.
npx skills add majiayu000/claude-skill-registry --skill bv-carmandale-agent-config --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# BV - Beads Viewer A high-performance TUI and graph-aware triage engine for the [Beads](https://github.com/steveyegge/beads) issue tracker. Treats your project as a **Directed Acyclic Graph (DAG)**, computing 9 graph-theoretic metrics to surface hidden dependencies, bottlenecks, and optimal work ordering. ## CRITICAL: Robot Mode Required for AI Agents **NEVER run bare `bv`** - it launches an interactive TUI that blocks your session! ```bash # WRONG - blocks terminal with TUI bv # CORRECT - JSON output for agents bv --robot-triage bv --robot-plan bv --robot-insights ``` **Always use `--robot-*` flags for machine-readable output.** --- ## Quick Reference for AI Agents ### The Mega-Command: Start Here ```bash # THE SINGLE ENTRY POINT - returns everything you need bv --robot-triage ``` **Returns:** - `quick_ref`: at-a-glance counts + top 3 picks - `recommendations`: ranked actionable items with scores, reasons, unblock info - `quick_wins`: low-effort high-impact items - `blockers_to_clear`: items that unblock the most downstream work - `project_health`: status/type/priority distributions, graph metrics - `commands`: copy-paste shell commands for next steps ### Minimal Alternative ```b
- CRITICAL: Robot Mode Required for AI Agents
- Quick Reference for AI Agents
- The Mega-Command: Start Here
- Minimal Alternative
- Why Use BV
- Graph Intelligence vs. List Thinking
- Use Cases
- The 9 Graph Metrics
- Understanding the Metrics
- Command Reference
- Triage & Planning
- Graph Analysis
- History & Change Tracking
- Sprint & Forecasting
WRONG - blocks terminal with TUI bv CORRECT - JSON output for agents bv --robot-triage bv --robot-plan bv --robot-insights THE SINGLE ENTRY POINT - returns everything you need Just the single top pick + claim command bv --robot-next bv --robot-triage | jq '.recommendations[0]'
What does the bv skill do?
Beads Viewer - graph-aware triage engine for Beads issue tracker with 9 graph metrics (PageRank, betweenness, HITS, etc.), dependency-aware planning, and purpose-built robot protocol for AI agents.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill bv-carmandale-agent-config --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.