Documentation

Beadbox is a real-time visual dashboard for the beads issue tracker. It turns your local beads database into dependency graphs, epic progress trees, and live dashboards that update as your agents work.

Getting Started

Install the beads CLI and Beadbox, set up your first workspace, and learn the layout.

Keyboard Shortcuts

Vim-style navigation, view switching, and all available keybindings.

Core Concepts

The beads data model: workspaces, beads, epics, dependencies, and comments.

Agent Setup

Wire your AI coding agents to the bd CLI and connect them to Beadbox.

Custom Statuses

Add your own workflow states beyond the five built-in statuses.

Connecting to a Dolt Server

Multi-writer access and team workflows via a running Dolt SQL server.