Skip to content

Github · GitHub Repository Radar

mantoni beads-ui

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

Stars

721

Active Stable

Forks

103

Watchers: 721

Repository Radar Score

49 / 100

Growth

7d
+0
30d
+0
%
0.0%

Not enough metric snapshots yet to chart growth for this repository.

Score breakdown

  • popularity 51
  • growth 0
  • activity 75
  • freshness 100
  • community 84

Need help integrating this stack?

Our team builds with modern open-source stacks. Tell us what you are shipping.

Get a quote →

Beads UI

Local UI for the bd CLI – Beads
Collaborate on issues with your coding agent.

npm Version SemVer Build Status MIT License

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

Setup

npm i beads-ui -g
# In your project directory:
bdui start --open

See bdui --help for options.

Screenshots

Issues

Issues view

Epics

Epics view

Board

Board view

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.
  • HOST: overrides the bind address (default 127.0.0.1).
  • PORT: overrides the listen port (default 3000).

These can also be set via CLI options: bdui start --host 0.0.0.0 --port 8080

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

  • 🔨 Clone the repo and run npm install.
  • 🚀 Start the dev server with npm start.
  • 🔗 Alternatively, use npm link to link the package globally and run bdui start from any project.

Debug Logging

  • The codebase uses the debug package with namespaces like beads-ui:*.
  • Enable logs in the browser by running in DevTools:
    • localStorage.debug = 'beads-ui:*' then reload the page
  • Enable logs for Node/CLI (server, build scripts) by setting DEBUG:
    • DEBUG=beads-ui:* bdui start
    • DEBUG=beads-ui:* node scripts/build-frontend.js

License

MIT

Created: Oct 22, 2025

Last push: Aug 11, 2026

Default branch: main

Latest release: v0.12.6

Languages

Share of the codebase by language, based on repository metadata from the host.

  • JavaScript 92.9%
  • CSS 6.3%
  • TypeScript 0.6%
  • HTML 0.2%

Repository Radar analysis

Deterministic insights derived from public metadata and our observations — not personal testing or reviews.

Why this repository is interesting

  • Listed in our discovery index with public GitHub metadata for analysis.

Who should use it

  • Developers working primarily with JavaScript
  • Teams exploring AI tooling, agents, or ML infrastructure

Potential use cases

  • Reference or evaluate JavaScript open-source approaches in this domain
  • Prototype AI/agent workflows or study reference architectures

Strengths

  • README present in our index
  • Declared license: MIT License

Limitations / considerations

  • Insights are derived from public metadata and our observations — not a substitute for code review

What to watch

  • Re-check last push, issues, and releases on GitHub before production adoption

Source: GitHub (public metadata) + Repository Radar analysis. We do not claim ownership of third-party repositories.

Ready to ship something that compounds?

Share your roadmap. We’ll come back with scope options, timeline ranges, and who from Shriram IT Ventures should be in the room.

Popular with product teams