Neura Market
Beads Ui logo

Beads Ui

Free

Local UI for Beads — Collaborate on issues with your coding agent.

FreeFree tier
#JavaScript
Type
Saas
Visit Website GitHub (596 stars)

About Beads Ui

Beads UI is a local web-based interface for the Beads issue tracking system, designed to enable developers to collaborate on issues with their coding agents. It offers zero-setup startup via the bdui CLI, live updates by monitoring the Beads database, and multiple views (issues, epics, board) for managing work. Additional features include keyboard navigation, inline editing, filtering and search, and multi-workspace support. The tool is open source under the MIT license.

Key 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 – Blocked / Ready / In progress / Closed columns
Keyboard navigation – navigate and edit without touching the mouse
Multi-workspace – switch between projects via dropdown, auto-registers workspaces

Pros & Cons

Pros
  • Zero setup required – just run bdui start after global npm install
  • Live updates ensure the UI reflects database changes in real time
  • Multiple view types (issues, epics, board) cover different project management needs
  • Keyboard navigation allows efficient operation without a mouse
  • Multi-workspace support with automatic registration simplifies project switching
Cons
  • Requires Node.js and npm to install and run locally
  • Only works within the Beads ecosystem (requires bd CLI and database)
  • No cloud-hosted version – must be run on the local machine
  • Windows support is limited for CLI commands (opening URLs and daemon stopping)

Best For

Collaborating on development issues with AI coding agentsTracking project progress through epics and board viewsManaging issues across multiple workspacesEditing and filtering issues inline for rapid workflow

FAQ

How do I install and start Beads UI?
Install globally via `npm i beads-ui -g`, then in your project directory run `bdui start --open` to launch the UI and open it in your browser.
Is Beads UI free to use?
Yes, it is open source under the MIT license and completely free to use.
Can I use Beads UI on Windows?
macOS and 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, which may have limitations.
What environment variables does Beads UI support?
BD_BIN (path to bd binary), BDUI_RUNTIME_DIR (override runtime directory for PID/logs; defaults to $XDG_RUNTIME_DIR/beads-ui or system temp), HOST (bind address, default 127.0.0.1), PORT (listen port, default 3000). These can also be set via CLI options.