Beads 是一个专为 AI 编程助手设计的分布式任务追踪系统，GitHub 22.4K Star。解决痛点：多个 AI 编程助手（Claude Code、Codex）处理复杂项目时，任务一多容易乱套，上下文经常丢失。

以前管理任务要么用 Jira（对 AI 太复杂），要么用 Markdown（太散，版本控制搞不定）。AI 上下文窗口虽大，但处理长期项目还是容易迷失方向。Beads 就像给 AI 装了「项目经理大脑」，把任务管理得井井有条。

项目介绍

Beads 由 gastownhall 团队开发，是分布式图状任务追踪器，专为 AI 编程助手打造。核心理念：用结构化、持久化方式管理任务，替代乱糟糟的 Markdown 计划。

这是更大愿景 Gas Town 的底层基石。Gas Town 被称为 AI Coding 领域的「Kubernetes」，Beads 是它的记忆系统。

苏米注：Beads 不引入任何外部中心化服务，充分利用现有 Git 仓库。任务数据存储在 .beads/ 目录，完全用 Git 做版本控制和同步。多个 Agent 在不同分支并行工作，最后像合并代码一样合并任务，零冲突。

核心亮点

1. Dolt 驱动：版本控制的数据库

Beads 底层是 Dolt——支持版本控制的 SQL 数据库，不是普通 SQLite 或 MySQL：

• 单元格级合并：多个 Agent 修改同一任务的不同字段时，像 Git 合并代码一样智能合并
• 原生分支支持：每个 Agent 在自己分支工作，互不干扰
• 内置同步：通过 Dolt remotes 在不同机器间同步任务数据

Dolt 让任务管理拥有 Git 的版本控制能力，又保持 SQL 数据库的查询便利性。

2. AI 优化设计

Beads 从一开始就是为 AI 设计的，不是给人类用的 Jira 改改：

• JSON 原生输出：所有命令支持 --json 输出，AI 解析毫不费力
• 依赖追踪：自动维护任务间的依赖关系图
• 自动就绪检测：bd ready 命令列出所有没有阻塞的可执行任务，AI 不用自己梳理优先级

3. 零冲突设计

多 Agent 协作场景下冲突是最大噩梦。Beads 用巧妙的解决方案：

• 哈希 ID：每个任务有唯一哈希 ID（如 bd-a1b2c），避免命名冲突
• 分布式存储：任务数据存储为文件，通过 Git 同步，天然支持分布式协作
• 智能合并：基于 Dolt 的单元格级合并，最大限度减少冲突

4. 记忆衰减机制

AI 上下文窗口虽大但还是有限的。Beads 有「记忆衰减」（Compaction）功能：

• 语义摘要：自动把已完成旧任务压缩成摘要
• 节省窗口：只把关键信息留给 AI，不浪费 Token
• 按需展开：需要时仍可查看完整历史

踩坑记录：这个功能对长期项目特别有用——AI 不用每次都从头读几百条任务历史，只看摘要就能快速恢复上下文。

5. 图状链接

任务不是孤立列表，而是知识图谱：

• relates_to：相关任务
• duplicates：重复任务
• supersedes：替代任务
• replies_to：回复关系

这些链接让 AI 能理解任务之间的上下文关系。

快速上手

安装方式

Homebrew（推荐，macOS）：

brew install beads

NPM：

npm install -g @beads/bd

安装脚本：

curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash

Go 安装：

go install github.com/gastownhall/beads/cmd/bd@latest

基本使用

初始化项目：

cd your-project
bd init
echo "Use 'bd' for task tracking" >> AGENTS.md

创建任务：

bd create "实现用户登录功能" -p 0  # P0 紧急任务
bd create "修复数据库连接bug" -p 1 -t bug  # P1 高优先级 bug

查看就绪任务：

bd ready  # 列出所有没有阻塞的任务

认领任务：

bd update bd-a1b2c --claim  # 原子操作：设置分配者 + 状态改为进行中

添加依赖：

bd dep add bd-a1b2c bd-d3e4f  # 任务 a1b2c 依赖 d3e4f

查看任务详情：

bd show bd-a1b2c  # 查看完整详情和审计历史

关闭任务：

bd close bd-a1b2c "已完成"

同步：

bd sync  # 与 Git 同步

备份与迁移

# 设置备份目标
bd backup init /path/to/backup
bd backup sync

# 恢复到新项目
bd init
bd backup restore --force /path/to/backup

解决的痛点

Beads 解决 AI 协作中的几个核心痛点：

适用人群：经常让 AI 助手处理复杂多步骤项目，或尝试多 Agent 协作的开发者。Beads 就像给 AI 配了个专业项目经理，让协作过程井井有条。

项目地址：github.com/gastownhall/beads

官方文档：gastownhall.github.io/beads