Beads UI

Local‑first UI for the bd CLI – Beads

Features

• ✨ Zero setup – just run bdui start
• 📺 Live updates – Monitors the beads database for changes
• 🔎 Issues view – Filter and search issues, edit inline
• ⛰️ Epics view – Show progress per epic, expand rows, edit inline
• 🏂 Board view – Open / Blocked / Ready / In progress / Closed columns
• ⌨️ Keyboard navigation – Navigate and edit without touching the mouse

Setup

npm i beads-ui -g
# In the project directory with a beads database:
bdui start --open

See bdui --help for options.

Screenshots

Issues

Epics

Board

Environment variables

• BD_BIN: path to the bd binary.
• BDUI_RUNTIME_DIR: override runtime directory for PID/logs. Defaults to $XDG_RUNTIME_DIR/beads-ui or the system temp dir.
• BDUI_NO_OPEN=1: disable opening the default browser on start. Note: Opening the browser is disabled by default; use --open to explicitly launch the browser, which overrides this env var.
• PORT: overrides the listen port (default 3000). The server binds to 127.0.0.1.

Platform notes

• macOS/Linux are fully supported. On Windows, the CLI uses cmd /c start to open URLs and relies on Node’s process.kill semantics for stopping the daemon.

Developer Workflow

• 📦 Make sure you have beads-mcp installed.
• 🤖 Ask your agent of choice. It will know.

License

MIT