Skip to content

Views

BeadSpec has five built-in views, selectable from the navigation bar at the top of the window. Each view is a different lens on your project's issues.

All

Shows every issue in the project. Use the filter bar to narrow down by status, assignee, priority, label, or free text. This is the default view when you open a project.

Focus

Shows only issues assigned to you. Within Focus, issues are grouped by status so you can see at a glance what is open, in progress, or blocked. This view automatically uses your Identity → Actor setting to determine "you".

Ready

Shows issues with no unresolved blockers — i.e. issues where every dependency is either closed or does not exist. The Ready view also shows dependency lineage hints, so you can see at a glance which chain of work an issue belongs to. Use this view during sprint planning to find what can actually be started now.

Health

A tabbed panel with two sub-views:

Checks — runs bd diagnostic commands against the connected project and shows pass/fail results for each:

  • Preflightbd preflight (combined pre-PR gate)
  • Doctorbd doctor (project health)
  • Lintbd lint (issue quality)
  • Stalebd stale (inactive issues)
  • Orphansbd orphans (broken dependencies)

Checks run automatically when you open the Health view and can be re-run manually with the Re-run button.

Formulas — lists bd workflow formulas available for the connected project. Click Pour next to a formula to run it. A confirmation dialog appears before any formula is executed; output (stdout/stderr) is shown inline after the pour.

OpenSpec (Changes)

Optional. Requires the openspec CLI and Settings → Features → OpenSpec integration enabled. If OpenSpec is disabled or not installed, this view does not appear in the navigation.

Browse in-flight and archived change proposals from your project's openspec/changes/ directory. Click a change to open its artifacts (proposal, spec, design, tasks) as read-only tabs in the workspace. Task completion status is pulled live from the Beads database.

See Integrations → OpenSpec for more detail.

Released under the MIT OR Apache-2.0 License.