Beads：编码代理的分支感知内存
用基于Dolt的依赖感知图替代杂乱无章的Markdown计划，为编码代理提供持久的结构化内存。
- Star 数
- ★ 28k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Go
- FA 评分
- 53/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 想要为AI编码代理提供可靠任务记忆的开发者，使用Beads来跟踪长期项目中的问题和待办事项。
- 不适合
- 只想用简单待办清单、不需要依赖图与压缩等概念的轻量用户
- 不愿额外维护 Dolt 数据库与跨机同步的团队
- 需要完全离线、拒绝执行安装脚本或校验下载二进制的环境
- 源码审查
- 53/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Beads是一个分布式图式问题追踪器，为编码代理提供持久化、结构化的内存。它以Dolt（一个版本控制的SQL数据库）为基础，提供单元格级合并、原生分支和同步功能。Beads通过依赖关系图替代了杂乱的Markdown计划，让代理无需丢失上下文即可处理长期任务。它提供JSON输出、依赖跟踪和自动就绪任务检测等功能，并采用基于哈希的ID（如bd-a1b2）来避免冲突。Beads支持嵌入式和服务器模式，可跨机器同步，并具有上下文窗口压缩和消息、图链接等功能。它可集成到Claude Code、Codex等代理中，支持macOS、Linux、Windows和FreeBSD平台。
Beads（bd命令）提供一系列CLI命令来管理供AI代理使用的问题图。它可以初始化项目（bd init），并安装代理集成（如bd setup claude、bd setup codex）。代理可以列出可认领的任务（bd ready）、创建新任务（bd create）、原子认领任务（bd update --claim）、显示任务详情（bd show）、关闭任务（bd close）以及关联任务（bd dep add）。它还提供bd prime来打印工作流上下文和持久内存，以及bd remember来存储项目记忆。Beads使用Dolt数据库（嵌入式或服务器模式）存储数据，并通过git remote（bd dolt push/pull）同步。它支持层次化ID（如bd-a3f8.1）用于史诗，并具有压缩功能来归档旧任务。
- 想要为AI编码代理提供可靠任务记忆的开发者，使用Beads来跟踪长期项目中的问题和待办事项。
- 使用Claude Code或Codex CLI的团队，安装Beads以自动创建AGENTS.md、钩子和设置。
- 在多代理或多分支环境中工作的维护者，利用哈希ID和Dolt合并来避免冲突。
- 需要跨机器同步任务状态的远程团队，通过git remote使用bd dolt push/pull。
- 希望在不使用git的项目（如非git VCS或CI/CD）中管理任务的用户，可以通过--stealth模式使用Beads。
如何安装或部署这个 Agent？
从GitHub releases安装最新版本：
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash或者使用包管理器：
brew install beads
# 或者
npm install -g @beads/bd如何使用这个 Agent？
在你的项目目录中初始化Beads：
cd your-project
bd init可选地安装代理集成（例如Claude Code）：
bd setup claude常用命令：
- bd ready 查看没有未解决阻断器的任务。
- bd create "Title" -p 0 创建P0任务。
- bd update <id> --claim 领取任务。
- bd close <id> "Fixed" 关闭任务。
- bd prime 打印工作流上下文和持久记忆。
- bd remember "insight" 存储项目记忆。
这个 Agent 有哪些优点和局限？
- 基于Dolt的版本控制数据库提供单元格级合并和分支能力，支持复杂多代理工作流。
- 哈希ID和依赖图结构消除了合并冲突，使多代理协作更流畅。
- 针对代理优化的JSON输出和自动就绪任务检测，可无缝集成到代理工作流中。
- 提供Stealth模式，可在不使用git的项目中使用，增加灵活性。
- 跨平台支持（macOS、Linux、Windows、FreeBSD）和多种安装方式。
- 需要学习新的CLI命令和概念（如beads、依赖图、压缩），可能对不熟悉此类工具的开发者有学习曲线。
- 对于小型项目，可能过于复杂，不适合简单的待办事项管理。
- 依赖Dolt数据库，增加了存储和同步的复杂性，可能需要额外的维护。
- 安装脚本执行代码，需要用户信任来源并验证校验和。
- 某些高级功能（如服务器模式、跨机器同步）可能需要额外配置。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Beads：编码代理的分支感知内存 当前 | 53 · 缺口较多 | 命令行工具免费 | ★ 28k | 今天 | Go | Codex · Claude Code |
| SkillKit — AI Agent 技能包管理器 | 40 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.6k | 4 个月前 | TypeScript | ChatGPT · Claude Code |
| 智坤代码 (ZhikunCode) | 56 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 525 | 1 天前 | Java | OpenAI API · Claude API |
| PowerContext | 55 · 缺口较多 | 命令行工具免费 | ★ 1.3k | 今天 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 和 SECURITY.md 明确说明本地优先、无遥测，但 Dolt 依赖默认收集指标，需用户手动禁用；安装脚本验证校验和，但未提供用户确认步骤；数据流透明性较好，文档说明数据存储位置和同步机制；敏感数据处理不足，明文存储令牌，无加密；依赖安全有 go.sum 固定和 Renovate 监控，但依赖数量庞大；外部影响有限，但 git 操作和 Dolt 同步可能产生副作用；回滚支持有限，仅通过 Dolt 历史；来源归属不明确，发布者未验证。扣分原因：缺少用户确认机制、敏感数据明文存储、依赖过多、发布者身份未知。
证据显示：README 和 SECURITY.md 内容一致，命令描述清晰；依赖通过 go.sum 固定，但 Dolt 等依赖可能不可用；失败消息提供可操作错误，如 schema 版本不匹配。扣分原因：依赖可用性未验证，失败消息仅部分覆盖。
证据显示：明确目标用户为编码代理，场景包括多代理、CI/CD、非 git 环境；能力边界清晰，如 stealth 模式、contributor 模式；触发精度高，命令明确；环境适配广泛，支持多平台。扣分原因：未提供详细的环境配置示例。
证据显示：文档结构清晰，有安装指南、FAQ、已知限制；安装说明详细，支持多种方式；命名稳定，但版本号未明确；示例和 FAQ 存在；已知限制明确；MIT 许可证；版本变更日志未提供；维护责任未明确。扣分原因：缺少版本变更日志、维护责任不明确。
证据显示：输出可用性高，提供 JSON 输出；边际价值高，解决代理记忆问题；成本效益未充分说明，依赖复杂。扣分原因：成本效益分析不足。
证据显示：README 中的声明部分有文档支持，但未提供测试结果；跨来源验证不足，仅依赖单一仓库；事实与推断分离不明确。扣分原因：缺乏测试证据和外部验证。
- Dolt 默认收集指标，需用户手动禁用，可能违反隐私预期。
- 敏感数据（如 API 令牌）以明文存储，无加密，不适合生产环境。
- 依赖数量庞大，增加供应链风险，需定期审计。
- 发布者身份未验证，安装前应验证校验和。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v1.3.2-rc.2 预发布
发布说明摘录
beads v1.3.2-rc.2 Pre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android/Termux (ARM64), and FreeBSD. Installation (release candidate) > This is a prerelease for validation. The stable install channels — > Homebrew, the install.sh / install.ps1 scripts, npm, and PyPI — > intentionally keep serving the latest stable release, so they will not > install this RC. Use one of the methods below. Manual download (recommended): Download the archive for your platform from the Assets below, extract it, …在 GitHub 查看 ↗ -
发布说明摘录
<!-- STYLE: follows the v1.3.0 release body (title, version/date line, framing intro, Highlights -> Upgrading Notes -> Added -> Changed -> Fixed -> Validation -> Installing -> Contributors -> Full Changelog; bolded operative sentence then dense prose; refs inline as #NNNN; operator-facing; no emoji), scaled down for a patch release the way v1.2.2 was framed. SPAN: v1.3.0 -> v1.3.1 = the CHANGELOG sections [1.3.1], [1.3.1-rc.2] and [1.3.1-rc.1] at the v1.3.1 tag (c1c4b642a), cross-checked against git log v1.3.0..v1.3.1 and the PRs it references. …在 GitHub 查看 ↗