The Web UI for Beads

See your issues,
not just track them

Pearl is the visual interface for the Beads issue tracker. Table views, board views, keyboard-driven workflows — all running locally from one command.

npx pearl-bdui

Requires Node.js 22+. Starts a local server with the web UI.

Why Pearl?

Visual triage at a glance

Table views, board views, and dependency graphs. See status, priority, and blockers without leaving your editor's mental model.

Keyboard-first workflows

Navigate, filter, and update issues without touching the mouse. Vim-style shortcuts, command palette, and bulk actions built in.

AI-agent collaboration

Agents use the Beads CLI to create, update, and close issues. Pearl surfaces their work in real time — triage what your agents produce.

Git-native data layer

Built on Dolt, every change is a commit. Branch issues alongside code, merge across workstreams, and time-travel through history.

One command to start

Run npx pearl-bdui and you have a full web UI. No accounts, no infrastructure, no configuration files to write.

Private by default

Everything runs on your machine. No telemetry, no cloud sync, no vendor lock-in. Your issues stay yours.

Start triaging in seconds

One command gives you a full issue-tracking UI. No accounts, no setup.