You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
┌─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬──────────┐
│ ` │ ! 1 │ 2 │ 3 │ 4 │ ' 5 │ 6 │ 7 │ 8 │ 9 │ 0 │ [ - │ ] = │ ⌫ Back │
│Tutr │Alert│ │ │ │Recpe│ │ │ │ │ │Label│Attn │ │
├─────┴──┬──┴──┬──┴──┬──┴──┬──┴──┬──┴──┬──┴──┬──┴──┬──┴──┬──┴──┬──┴──┬──┴──┬──┴──┬───────┤
│ ↹ │ │ w W │ │ r R │ t T │ y Y │ │ i I │ o O │ p P │ │ │ │
│ Tab │ │Repos│ │Ready│Time │Copy │ │Insit│Open │Prior│ │ │ │
├────────┴┬────┴┬────┴┬────┴┬────┴┬────┴┬────┴┬────┴┬────┴┬────┴┬────┴┬────┴┬────┴───────┤
│ ⇪ │ a A │ s S │ │ f F │ g G │ h H │ j J │ k K │ l L │ ; : │ │ ⏎ Enter │
│ Caps │All │Sort │ │Flow │Graph│Hstry│Down │ Up │Label│Short│ │ Select │
├─────────┴───┬─┴───┬─┴───┬─┴───┬─┴───┬─┴───┬─┴───┬─┴───┬─┴───┬─┴───┬─┴───┬─┴────────────┤
│ ⇧ Shift │ │ x X │ c C │ v V │ b B │ │ │ / ? │ │ │ ⇧ Shift │
│ │ │Exprt│Close│Cass │Board│ │ │Srch │Help │ │ │
├──────┬──────┴─┬───┴───┬─┴─────┴─────┴─────┴─────┴─────┴───┬─┴───┬─┴───┬─┴───┬──────────┤
│ Ctrl │ Alt │ Super│ Space │Super│ Alt │Ctrl │ Arrows │
│ ^ │ │ │ │ │ │ ^ │ ← ↓ ↑ → │
└──────┴────────┴───────┴────────────────────────────────────┴─────┴─────┴─────┴──────────┘
Key:
Top text = Primary function (lowercase key)
Bottom text = Common action shortcut
! 1 = Shift+number function
Version Information
This keyboard reference is current as of beads_viewer v1.0.
🐛 HIGH OPEN bv-abc123 Fix authentication bug 2d ago 💬3 ⚡8
│ │ │ │ │ │ │ │
│ │ │ │ │ │ │ └─ Importance score
│ │ │ │ │ │ └────── Comments (3)
│ │ │ │ │ └──────────── Created 2 days ago
│ │ │ │ └───────────────────────────────────── Title
│ │ │ └──────────────────────────────────────────────── Issue ID
│ │ └─────────────────────────────────────────────────────── Status
│ └───────────────────────────────────────────────────────────── Priority
└──────────────────────────────────────────────────────────────── Type icon
Type Icons
Icon
Type
Meaning
🐛
Bug
Something broken that needs fixing
✨
Feature
New functionality to add
📋
Task
Regular work item
🎯
Goal
High-level objective
What to Press on This Screen
┌────────────────────────────────────────────────────────────────┐
│ ON LIST VIEW - WHAT TO PRESS │
├────────────────────────────────────────────────────────────────┤
│ Movement: │
│ j/k or ↓/↑ Move through list │
│ g/G Jump to top/bottom │
│ Enter Open selected issue │
│ │
│ Filters (show/hide issues): │
│ o Show only OPEN issues │
│ r Show only READY (unblocked) issues │
│ c Show only CLOSED issues │
│ a Show ALL issues │
│ │
│ Search: │
│ / Start searching (type to filter) │
│ n/N Jump to next/previous search result │
│ │
│ Sort: │
│ s Change sort order (press multiple times) │
│ │
│ Switch Views: │
│ b Switch to BOARD view (Kanban) │
│ g Switch to GRAPH view (dependencies) │
│ i Switch to INSIGHTS (analytics) │
│ h Switch to HISTORY (timeline) │
│ │
│ Help: │
│ ? Show help for this screen │
│ ` Open interactive tutorial │
│ ; Show shortcuts sidebar │
│ │
│ Quit: │
│ q Quit bv │
└────────────────────────────────────────────────────────────────┘
┌────────────────────────────────────────────────────────────────┐
│ ON BOARD VIEW - WHAT TO PRESS │
├────────────────────────────────────────────────────────────────┤
│ Movement: │
│ h/l or ←/→ Move between columns (left/right) │
│ j/k or ↓/↑ Move within column (down/up) │
│ 1, 2, 3, 4 Jump directly to column 1, 2, 3, or 4 │
│ H Jump to first column │
│ gg Jump to top of current column │
│ G Jump to bottom of current column │
│ │
│ View Details: │
│ Enter Open selected issue │
│ Tab Toggle detail panel on/off │
│ │
│ Actions: │
│ y Copy issue ID to clipboard │
│ s Change grouping (Status/Priority/Type) │
│ │
│ Search: │
│ / Search in board │
│ n/N Next/previous search result │
│ │
│ Back: │
│ b or Esc Return to list view │
│ q Quit bv │
└────────────────────────────────────────────────────────────────┘
Graph View - Dependencies
Press g from any view to see the dependency graph.
┌────────────────────────────────────────────────────────────────┐
│ ON HISTORY VIEW - WHAT TO PRESS │
├────────────────────────────────────────────────────────────────┤
│ Movement: │
│ j/k Move in primary pane (down/up) │
│ J/K Move in secondary pane (down/up) │
│ Tab Cycle focus (list → detail → files) │
│ │
│ View Options: │
│ v Toggle Bead/Git mode │
│ f Toggle file tree panel │
│ │
│ Search & Filter: │
│ / Search commits or beads │
│ c Cycle confidence filter │
│ │
│ Actions: │
│ y Copy commit SHA to clipboard │
│ o Open commit in web browser │
│ Enter Jump to selected bead │
│ │
│ Back: │
│ h or Esc Return to list view │
│ q Quit bv │
└────────────────────────────────────────────────────────────────┘
Common Symbols & Icons
Priority Indicators
Symbol
Priority
Action Required
🔥
CRITICAL
Urgent, immediate attention
⚡
HIGH
High priority, handle soon
🔹
MEDIUM
Normal priority
💤
LOW
Low priority, can wait
Type Icons (What Kind of Work)
Icon
Type
Description
🐛
Bug
Something broken - fix required
✨
Feature
New functionality - sparkles = new & shiny
📋
Task
Regular work item - checklist
🎯
Goal
High-level objective - target to hit
Dependency Indicators
Symbol
Meaning
What to Do
⚡→3
Blocks 3 issues
Complete this to unblock others
💬5
5 comments
Active discussion, check comments
Pink edge
Critical path
On longest dependency chain - zero slack
Health & Status
Symbol
Meaning
Interpretation
✓
Healthy/Complete
Good status, no action needed
✗
Problem/Incomplete
Needs attention
●
Active/In Progress
Currently being worked on
○
Open/Created
Available to start
Status Indicators
In Lists
OPEN = Not started yet
READY = No blockers, can start immediately
BLOCKED = Waiting on dependencies
DONE = Completed
In Detail View
**Status:** READY
**Priority:** HIGH
**Blocks:** 3 issues ← This blocks 3 other issues
**Blocked by:** 1 issue ← Can't start until 1 dependency completes
Quick Reference by Screen
"I'm on LIST view, what do I press?"
Movement: j/k (up/down) g/G (top/bottom)
Filters: o (open) r (ready) c (closed) a (all)
Search: / (search) n/N (next/prev result)
Views: b (board) g (graph) i (insights) h (history)
Help: ? (help) ` (tutorial) ; (shortcuts)
"I'm on BOARD view, what do I press?"
Movement: h/l (left/right columns) j/k (up/down in column)
Jump: 1/2/3/4 (jump to column) H (first column)
Actions: y (copy ID) s (change grouping)
Search: / (search) n/N (next/prev)
Back: b or Esc (list view)
"I'm on GRAPH view, what do I press?"
Movement: j/k (nodes up/down) h/l (siblings left/right)
Scroll: H/L (scroll view) Ctrl+D/U (page up/down)
Actions: f (focus subgraph) Enter (view details)
Back: g or Esc (list view)
"I'm on INSIGHTS view, what do I press?"
Movement: h/l (switch panels) j/k (move in panel)
Navigate: Tab/Shift+Tab (cycle panels)
Options: e (explanations) x (proofs) m (heatmap)
Actions: Enter (drill into issue)
Back: i or Esc (list view)
"I'm on HISTORY view, what do I press?"
Movement: j/k (primary pane) J/K (secondary pane)
Navigate: Tab (cycle focus)
View: v (toggle Bead/Git) f (file tree)
Search: / (search) c (confidence filter)
Actions: y (copy SHA) o (open browser) Enter (jump)
Back: h or Esc (list view)
Special Screens
Help Overlay (Press ?)
┌─ Help ────────────────────────────────────────────────────────┐
│ Context-specific help for current view │
│ │
│ j/k Navigate │
│ Space Open full tutorial │
│ Esc Close this help │
└────────────────────────────────────────────────────────────────┘
🐛 HIGH OPEN bv-123 Fix bug 2d ago 💬3 ⚡8
└── Type Priority Status ID Title Age Comments Score
Read each line left-to-right: Type → Priority → Status → ID → Title → Metadata
2. Panel Layout
Most views have 2-3 panels:
Left panel: List of items
Right panel: Details of selected item
Far right: Optional sidebar (shortcuts, metrics, etc.)
Use Tab to switch between panels.
3. Color Coding
Red/Pink: Errors, critical, urgent
Yellow/Gold: Warnings, important
Green: Success, healthy, completed
Blue/Cyan: Information, metadata
Gray: Muted, less important
4. When in Doubt
Press ? for context-specific help on ANY screen!
Screen-by-Screen Cheat Cards
📋 List View Card
┌─────────────────────────────────┐
│ LIST VIEW - AT A GLANCE │
├─────────────────────────────────┤
│ What you see: │
│ • List of issues/beads │
│ • Icons show type & priority │
│ • Detail panel on right │
│ │
│ Key presses: │
│ j/k Navigate │
│ o/r/c Filter Open/Ready/Close │
│ / Search │
│ b/g/i Switch views │
│ ? Help │
└─────────────────────────────────┘
📊 Board View Card
┌─────────────────────────────────┐
│ BOARD VIEW - AT A GLANCE │
├─────────────────────────────────┤
│ What you see: │
│ • 4 columns (TODO → DONE) │
│ • Cards in each column │
│ • ⚡→N shows blockers │
│ │
│ Key presses: │
│ h/l Move between columns │
│ j/k Move in column │
│ 1-4 Jump to column │
│ Tab Toggle details │
│ Esc Back to list │
└─────────────────────────────────┘
🕸️ Graph View Card
┌─────────────────────────────────┐
│ GRAPH VIEW - AT A GLANCE │
├─────────────────────────────────┤
│ What you see: │
│ • Boxes = issues/beads │
│ • Lines = dependencies │
│ • Pink = critical path │
│ │
│ Key presses: │
│ j/k Navigate nodes │
│ H/L Scroll view │
│ f Focus subgraph │
│ Enter View issue │
│ Esc Back to list │
└─────────────────────────────────┘
📈 Insights View Card
┌─────────────────────────────────┐
│ INSIGHTS VIEW - AT A GLANCE │
├─────────────────────────────────┤
│ What you see: │
│ • 🚧 Bottlenecks (prioritize) │
│ • 🏛️ Keystones (complete first) │
│ • 🌐 Influencers (review first) │
│ • 🛰️ Hubs, 📚 Authorities │
│ │
│ Key presses: │
│ h/l Switch panels │
│ Tab Next panel │
│ e/x/m Toggle overlays │
│ Enter Drill into issue │
│ Esc Back to list │
└─────────────────────────────────┘
⏱️ History View Card
┌─────────────────────────────────┐
│ HISTORY VIEW - AT A GLANCE │
├─────────────────────────────────┤
│ What you see: │
│ • Left: Bead timeline │
│ • Right: Git commits │
│ • ○●✓ show lifecycle │
│ • ⚡N shows event count │
│ │
│ Key presses: │
│ j/k Navigate left pane │
│ J/K Navigate right pane │
│ v Toggle Bead/Git mode │
│ y Copy SHA │
│ Esc Back to list │
└─────────────────────────────────┘
Summary - Universal Keys
These work EVERYWHERE:
? Help for current screen
` Full tutorial
; Shortcuts sidebar
q Quit / Go back
Esc Cancel / Close
Tab Switch panels
j/k Navigate down/up
g/G Top/bottom
When you're lost:
Press ? to see where you are
Press ` for the full tutorial
Press Esc to go back
Press q to quit
Next Steps
New user? Press ` to start the interactive tutorial
Need keyboard shortcuts? See KEYBOARD_REFERENCE.md
