Skip to content

Features

BrendanP edited this page Jun 26, 2026 · 1 revision

Features

A tour of what Bead Me Up, Scotty can do. Everything here runs against your real bd data (or the built-in dataset in Demo Mode).

Detail drawer
Detail drawer — inline edit, deps & comments
Dependency graph
Live dependency graph

Board

A five-column view: Backlog · Ready · In Progress · Blocked · Done. Cards are dense, showing id, type, priority, assignee, dependency/comment counts, and an origin badge.

  • Filter by type / priority / origin.
  • Full-text search across beads.
  • Show/hide archived toggle.
  • Keyboard: n new · / search · Esc close.

Drag-and-drop status changes

Drag cards between columns to change status. Updates are optimistic — the UI moves the card immediately and reconciles with bd.

  • Backlog = beads' deferred status.
  • Done = bd close.

Create & edit

Add tasks and epics with type, priority, description, assignee, labels, parent epic, and a "start in backlog" toggle. Edit status and priority inline from the board or the detail drawer.

Epics & progress

Epics are first-class. Each shows a live progress bar (closed ÷ children) and an expandable child list. Add a child straight into an epic, or jump from a bead's drawer to its epic on the Epics screen.

Dependencies & graph

  • View, add, and remove typed dependencies in the detail drawer.
  • Explore an interactive React Flow dependency graph — drag from one node to another to create a link.

Comments

Author-stamped comment threads with a composer on every bead.

Archive & delete

  • Archive — a reversible bd close plus an archived label.
  • Deletebd delete, behind a confirmation.

Human-vs-agent attribution

Every bead and comment shows 👤 (human) or 🤖 (agent), derived from a configurable human allowlist. See Configuration for how attribution is decided.

Multiple projects

Switch between projects from the project switcher — each project is a directory with its own .beads repo. Per-project state (like theme) is remembered.

More views & tools

Beyond the core board, the app includes:

  • Command palette — quick actions and navigation from the keyboard.
  • Insights — charts and rollups over your beads.
  • Activity feed — a stream of recent changes.
  • List view — a compact, sortable table of beads.
  • "Needs you" — surfaces beads waiting on a human.
  • Publish / showcase — generate a shareable static site and a delivery report from your beads.
  • Themes — light/dark and per-project theme selection.
  • Self-update — an in-app indicator when a newer build is available.

Settings

Configure the repo path, human actor + allowlist, poll interval, and theme. Live polling keeps the board fresh when agents change data underneath you.

Clone this wiki locally