A terminal user interface (TUI) for viewing and navigating Beads issues.

• Two-panel layout: Tree view on the left, issue details on the right
• Hierarchical display: Issues with dotted IDs (e.g., proj-abc.1.2) are shown as nested children
• Visual status indicators:
  • Green = Ready (no blockers)
  • Red = Blocked (has unresolved dependencies)
  • Gray = Closed
• Markdown rendering: Headers, code blocks, lists, tables, blockquotes, and inline formatting
• Inline editing: Edit issue titles and descriptions directly in the TUI
• Auto-refresh: Watches .beads/ directory for changes
• State persistence: Remembers expanded/collapsed state between sessions
• Mouse support: Click to select issues, scroll wheel in details panel

Requires Rust and the bd CLI to be installed.

git clone https://github.com/bglenden/bsv.git
cd bsv
cargo install --path .

This installs bsv to ~/.cargo/bin/, which is typically already in your PATH if you have Rust installed.

Run bsv from any directory containing a .beads/ folder (or a parent directory with one).

bsv [OPTIONS]

OPTIONS:
    --help     Print help message
    --debug    Dump tree structure and exit

Expanded state is saved to ~/.config/bsv/state.json, keyed by the path to each beads database.

• Beads (bd CLI) v0.34.0 or later
• A terminal with Unicode support

MIT License - see LICENSE for details.