Appearance
Beads (bd) - AI Agent 的 Git 原生分布式任务追踪系统
是什么
Beads 是一个基于 Git 的分布式任务追踪系统，专为 AI 编码 Agent 在跨会话、多 Agent 协作场景下管理任务而设计。
- GitHub： github.com/gastownhall/beads
- 作者： Steve Yegge（前 Google 工程师、Grok 作者）
- 文档： gastownhall.github.io/beads
- 关联项目： Gas Town — 多 Agent 工作空间管理器
- 定位： AI Agent 的持久化任务记忆系统
不是什么
- 不是 Jira / GitHub Issues 的替代品（是为 AI 代理设计的，不是给人用的）
- 不是 TODO.md（不是纯文本列表，是有结构、有依赖关系的数据库）
- 不是 MCP 服务器（提供 MCP 接口，但核心是 Dolt 驱动的本地数据库）
解决啥
| 痛点 | 方案 |
|---|---|
| AI Agent 跨会话丢失上下文 | Git 持久化任务状态，跨会话保持 |
| 多个 Agent 协作时任务冲突 | 基于 Hash 的 ID 避免冲突 |
| 任务依赖关系管理繁琐 | DAG（有向无环图）建模依赖与优先级，bd ready 自动展示可做任务 |
| 项目复杂度超出单 Agent 能力 | 通过 Epics、Molecules、Gates 管理复杂工作流 |
| Agent 不知道当前该做什么 | 自动检测"ready work"（无阻塞依赖 + 高优先级） |
好在哪
| 能力 | 说明 |
|---|---|
| Git 原生 | 以 Git 为分布式数据库，天然支持版本控制和协作 |
| DAG 依赖管理 | 任务间依赖关系清晰，可自动计算"可做任务" |
| 优先级系统 | 支持多级优先级，辅助 Agent 决策先后顺序 |
| MCP 支持 | 提供 MCP 服务器接口，Claude Code 可直接调用 |
| 多 Agent 协调 | 并行写入不冲突，协作无锁 |
| 轻量级 | 最小依赖，本地运行，无需中心服务器 |
- "任务即代码" (Tasks as Code)： 任务用结构化数据描述，可与代码一起版本管理
- AI 原生设计： 所有接口和输出都经过优化，确保 AI Agent 能理解和处理
- 4 维图结构： 用 DAG 同时表达"依赖""优先级""分组""执行状态"
怎么跑
安装
bash
# macOS / Linux / FreeBSD
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash
基础使用
bash
# 创建一个高优先级任务
bd create "设置数据库架构" -p 1 -t task
# 创建一个有依赖的任务
bd create "实现用户认证" --deps bd-101 -p 2 -t task
# 查看当前可执行的任务（无阻塞依赖）
bd ready
# 查看所有任务状态
bd list
与 Claude Code 集成（MCP）
bash
# 启动 MCP 服务器
beads-mcp
# 在 Claude Code 中连接 Beads MCP
# 然后问："我的最高优先级未阻塞任务是什么？"
管理复杂工作流
bash
# 创建 Epic（大范围工作）
bd create "V2 版本发布" -p 0 -t epic
# 给 Epic 分配 Issue
bd update bd-102 --epic bd-100
# 使用 Gates（门控条件）
bd create "等待 QA 通过" -p 1 -t gate --deps bd-105
# 使用 Molecules（任务分组）
bd molecule create "用户系统模块"
bd molecule add bd-102 "用户系统模块"
怎么用
- 单人 Agent 项目： 让 AI 编码代理在跨会话间保持项目状态和优先级
- 多 Agent 协作： 多个 Agent 并行工作，Beads 自动处理冲突
- 复杂项目管理： 用 Epics/Gates/Molecules 管理多阶段、多依赖的大项目
- CI/CD 集成： 任务状态同步到 Git，与现有 DevOps 流程衔接
- Gas Town 生态系统： 结合 Gas Town 实现更完整的 Agent 工作空间管理
延伸： Steve Yegge 设计的 Gas Town 愿景中，未来的软件开发将是无数 AI Agent 协作完成，Beads 是这一愿景的基础设施层。
by 文殊