gastownhall/beads

这是什么？

核心功能

• 01以依赖图存储任务，`bd ready` 列出没有阻塞项的可执行工作。
• 02通过 `bd update --claim` 原子化认领任务，适合多智能体协作。
• 03基于哈希的 ID 与 Dolt 分支机制，减少跨分支合并冲突。
• 04支持 epic 与子任务的层级 ID，并提供多种图关联类型。
• 05对旧的已关闭任务做语义压缩，节省上下文窗口。
• 06支持不依赖 git 的使用方式，并集成 Claude Code、Codex、Cursor 等智能体。

适用场景

• 为编码智能体在长周期、多步骤项目中提供持久化任务记忆。
• 协调多个智能体在不同分支上同时开发同一仓库。
• 向开源项目贡献代码时，把规划类任务与 PR 分开管理。
• 在 CI 或 Sapling、Jujutsu 等非 git 版本控制环境中做隔离的任务追踪。

快速上手

1. 1

   全局安装 bd 命令行工具

   按 README 中的官方说明安装
2. 2

   进入你的项目目录

   cd your-project
3. 3

   在项目中初始化 beads

   bd init

使用前须知

• !需要基于 Dolt 的数据库，团队需要理解这一额外依赖。
• !HTTP 后端的部分行为与本地模式不同，且该功能标注为实验性。
• !手动安装时需要自行验证二进制文件的校验和。

标签

常见问题

beads 是什么？

基于 Dolt 的分布式图状任务追踪工具，通过 bd 命令行为编程智能体提供持久化、带依赖关系的任务记忆。 Beads（命令行工具 `bd`）是为 AI 编程智能体设计的任务追踪工具。它不把计划写在零散的 Markdown 文件里，而是把任务存成带依赖关系的图，保存在支持版本控制的 SQL 数据库中。智能体可以查询没有未完成阻塞项的任务、原子化地认领任务，完成后相关的后续任务会自动变为可执行，便于在长周期工作中保持上下文。

beads 可以免费使用吗？用的什么许可证？

beads 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

beads 还在维护吗？

活跃维护中。beads 最近一次提交是在 2026年10月19日。

beads 适合用来做什么？

为编码智能体在长周期、多步骤项目中提供持久化任务记忆。 协调多个智能体在不同分支上同时开发同一仓库。 向开源项目贡献代码时，把规划类任务与 PR 分开管理。 在 CI 或 Sapling、Jujutsu 等非 git 版本控制环境中做隔离的任务追踪。

beads 怎么安装和运行？

全局安装 bd 命令行工具 进入你的项目目录: cd your-project 在项目中初始化 beads: bd init

在哪里获取 beads？

源代码和安装说明在 GitHub 上：https://github.com/gastownhall/beads