bv

Installation
SKILL.md

BV - Beads Viewer

A graph-aware triage engine for Beads projects (.beads/beads.jsonl). Computes 9 graph metrics, generates execution plans, and provides deterministic recommendations. Human TUI for browsing; robot flags for AI agents.

Why BV vs Raw Beads

Capability Raw beads.jsonl BV Robot Mode
Query "List all issues" "List the top 5 bottlenecks blocking the release"
Context Cost High (linear with issue count) Low (fixed summary struct)
Graph Logic Agent must compute Pre-computed (PageRank, betweenness, cycles)
Safety Agent might miss cycles Cycles explicitly flagged

Use BV instead of parsing beads.jsonl directly. It computes graph metrics deterministically.

CRITICAL: Robot Mode for Agents

Never run bare bv. It launches an interactive TUI that blocks your session.

Related skills
Installs
62
GitHub Stars
64
First Seen
Jan 20, 2026