22.4K Star！这个开源 AI 工具给 Agent 装上「项目经理大脑」！

这两天在 GitHub 上发现一个特别有意思的项目，直接登上了 Trending 榜单。

这个项目叫 Beads，专门解决一个越来越明显的痛点：当我们让多个 AI 编程助手（像 Claude Code、Codex 这些）一起处理复杂项目时，任务一多就容易乱套，上下文还经常丢失。

以前我们管理任务，要么用 Jira 这种重得要死的工具，要么就弄个 Markdown 文件随便列一下。Jira 对 AI 来说太复杂了，集成起来麻烦；Markdown 又太散，版本控制、依赖关系这些根本搞不定。

而且 AI 助手的上下文窗口虽然越来越大，但处理长期项目时，还是容易在海量信息里迷失方向。

Beads 可以说是恰到好处。它是专门为 AI 编程助手设计的分布式任务追踪系统，底层基于 Dolt——一个版本控制的 SQL 数据库。

这玩意儿就像给 AI 们装了个「项目经理大脑」，把任务管理得井井有条。

项目介绍

Beads 是由 gastownhall 团队开发的分布式图状任务追踪器，专门为 AI 编程助手打造。

它的核心理念是用结构化、持久化的方式来管理任务，替代以前那种乱糟糟的 Markdown 计划。

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

Beads 提供了一个依赖感知的图状数据结构，让 AI 助手能够处理长期、复杂的任务而不会丢失上下文。

Beads 最聪明的地方在于它不引入任何外部中心化服务，而是充分利用你现有的 Git 仓库。

任务数据就存储在 .beads/ 目录下，完全用 Git 来做版本控制和同步。多个 Agent 可以在不同分支上并行工作，最后像合并代码一样合并任务，零冲突。

核心亮点

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

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

• • 单元格级合并：多个 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
• • 按需展开：需要时仍然可以查看完整历史

5、图状链接

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

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

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

快速入手

Beads 提供了多种安装方式：

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

告诉 AI 助手用 Beads：

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 协作中的几个核心痛点：

1. 1. ✅ 上下文持久化：AI 重启不会丢失任务状态
2. 2. ✅ 依赖管理：自动计算就绪任务，不用手动梳理
3. 3. ✅ 分布式协作：多个 Agent 在不同分支工作零冲突
4. 4. ✅ 记忆衰减：自动压缩旧任务，节省上下文窗口
5. 5. ✅ 不依赖 Git：任何项目都能用
6. 6. ✅ 多种安装方式：一行命令就能上手

如果你经常让 AI 助手处理复杂的多步骤项目，或者在尝试多 Agent 协作，Beads 绝对值得一试。

它就像给 AI 们配了个专业的项目经理，让整个协作过程井井有条。

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

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