beads 问题追踪器的 GUI
为 beads 打造的原生桌面 GUI
bd CLI 擅长快速创建和关闭工作项。Beadbox 则是你需要一眼看清全貌时打开的工具：依赖图、epic 进度，以及每个 agent 当前的任务，都在同一个窗口中。
使用 Homebrew 安装
brew install --cask beadbox/beadbox/beadbox它能展示 CLI 做不到的东西
bd list 很适合把过滤后的视图拉到终端里。但当你有六个 epic、四十个 bead、错综复杂的依赖关系时，输出就变成一堵文字墙。你不得不反复查询，试图在脑子里重建整张依赖图。
Beadbox 直接把那张图画出来。每个 bead 是一个节点，每个 blocker 是一条边。你一眼就能看到工作卡在哪里、哪些 epic 真的快完成了、以及哪条依赖链会在下周咬你一口。
可视化依赖图
点击任意 bead 即可查看它被什么阻塞、又阻塞了什么。多级依赖链以交互式树形结构呈现，而非一串嵌套的 ID。
一眼看清 epic 进度
每个 epic 都会根据其子 bead 自动计算进度条。无需手动汇总状态，也不会有陈旧的仪表盘。整棵树实时反映数据库的状态。
从 CLI 实时更新
当 agent 执行 bd create 或 bd update 时，Beadbox 会在两秒内感知变更并重新渲染。你可以看着工作在 pipeline 中流动，无需手动刷新。
原生应用，不是 Electron
Beadbox 基于 Tauri 构建。这意味着它使用操作系统自带的 WebView，不会打包 Chromium，因此应用启动不到一秒，安装包仅约 20 MB。
它可以运行在 macOS（Apple Silicon 和 Intel）、Linux（AppImage 和 .deb）以及 Windows 上。全部来自同一份代码。
与你正在使用的 bd CLI 协同工作
Beadbox 不替代 bd。它读取的是与 CLI 命令写入同一个 Dolt 数据库。你可以继续在终端里使用 bd create、bd update 和 bd close。Beadbox 只是为同一份数据提供另一个窗口。
没有导入步骤，也没有配置文件。把它指向你的 workspace，它就开始渲染。
常见问题
- 使用 Beadbox 需要 bd CLI 吗？
- 需要。Beadbox 读取的是 bd 管理的数据库。先安装 bd（brew install beads），再安装 Beadbox。
- Beadbox 会取代 CLI 吗？
- 不会。CLI 在创建和更新单个 bead 时更快，Beadbox 更适合看清全局。大多数人两者都用。
- 我的数据会被发送到其他地方吗？
- 不会。你的 bead 存在本地的 Dolt 数据库里。Beadbox 直接读取。没有账号、没有云同步，也不会对你的问题数据进行任何遥测。
给你的 CLI 配一双眼睛
如果你已经在终端里使用 bd，Beadbox 能无缝接入，不会改变你的工作流程。安装一次，把它放在副屏上一直开着，就不用再去猜你的 agent 在做什么。