Rich terminal UI (Bubbletea) for browsing and editing beads (bd issue tracker).
- Go 100%
Peter Banka
5e9daa6790
Two-pane TUI (filterable list + live `bd show` preview) with category filters for the gastown workflow — hides gt:agent state beads, hq-* chatter, and wisps by default; hotkeys (C/H/G/W) toggle each back. Field edits (enter/t/a/n) shell out to $EDITOR. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .gitignore | ||
| bead.go | ||
| bead_test.go | ||
| go.mod | ||
| go.sum | ||
| live_test.go | ||
| main.go | ||
| README.md | ||
| view.go | ||
bd-ui
A rich terminal UI for browsing and editing beads
(bd) issues. Two panes — a filterable list and a live bd show preview — with
category filters and jump-to-$EDITOR field editing.
Built for the gastown workflow, where a beads DB mixes real work issues with
gt:agent state beads, hq-* HQ chatter, and ephemeral wisps. bd-ui hides the
noise by default and lets you toggle each category back with a hotkey.
Install
go install git.celilo.computer/celilo/bd-ui@latest
# or, in a clone:
go build -o bd-ui .
Usage
bd-ui # DB auto-discovered from CWD
bd-ui ~/hobby/test-gastown # point at a specific beads workspace
Keys
| Key | Action |
|---|---|
↑/k, ↓/j |
move cursor |
enter |
edit description in $EDITOR |
t / a / n |
edit title / acceptance / notes |
C |
toggle closed beads |
H |
toggle hq- beads |
G |
toggle gt:agent state beads |
W |
toggle wisp (ephemeral) beads |
/ |
fuzzy search (id + title) |
r |
reload · q quit |
Default view = open, non-hq, non-agent, non-wisp beads: your actual work.
Status
Scaffold / MVP. Tracked as a gastown rig. Open work is in the rig's beads
(bd list), e.g. richer preview, epic/dependency tree, reopen/close from the UI.