你是否遇到过这样的困扰:AI编程助手在处理复杂项目时,刚聊完模块A的设计,转头就忘了模块B的接口约定?或是执行多步骤重构任务时,中间断开后彻底丢失上下文?Beads 正是为此而生——它不是另一个代码生成器,而是一套轻量、可嵌入、带版本控制的“长期记忆系统”,专为Claude、Cursor、Continue等AI编码代理(Coding Agent)打造,将零散的提示词、Markdown计划和临时变量,升级为一张自动维护依赖关系的知识图谱。
核心功能
- 图谱化任务追踪:把传统线性待办清单升级为有向图结构,自动识别任务间的输入/输出依赖(例如“生成测试用例”必须在“实现函数逻辑”之后),避免AI执行顺序错乱
- Dolt 驱动的持久化存储:底层基于开源数据库 Dolt(Git for Data),所有任务节点、状态变更、关联代码片段均支持版本快照、分支对比与回滚,真正实现“记忆可追溯”
- 跨平台 CLI 一键集成:无需修改项目结构,只需在任意代码仓库中运行
bd init,即可为当前项目注入结构化记忆能力,支持 macOS / Linux / Windows / FreeBSD - 多语言生态友好:提供官方 npm 包(
@beads/bd)和 PyPI 包(beads-mcp),方便 Node.js 和 Python 生态的 AI 工具链无缝调用 - 语义化上下文注入:Agent 可通过
bd query按标签、状态、依赖路径实时检索历史任务,替代手工拼接长提示词,显著降低上下文噪声 - 轻量无侵入设计:不强制要求项目使用特定框架或配置文件,所有数据默认存于
.beads/目录,Git 忽略友好,开发者完全掌控数据主权
适合哪些人用
如果你是以下角色之一,Beads 将极大提升你的 AI 编程效率:AI 原生开发工具开发者(如编写 MCP Server、自研 Agent 框架);重度使用 Claude Code / Cursor / Continue 等智能编程助手的工程师,常需处理跨文件、多阶段的重构或新功能开发;技术团队的效能负责人,希望为团队统一沉淀 AI 协作过程中的决策依据与知识脉络;以及对 AI 记忆机制、智能体工程化感兴趣的开源实践者——Beads 的简洁架构与 MIT 协议,使其成为学习与二次开发的理想范本。
快速上手
安装只需一条命令(推荐系统级安装,一次配置,全局可用):
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash
进入你的项目目录,初始化记忆空间:
cd my-awesome-project
bd init
此时项目根目录会生成 .beads/ 文件夹。接下来,你可以在 Agent 提示词中明确指示:“请始终通过 bd list 查询当前任务状态,并用 bd add --depends-on=task-123 创建新任务”,让 AI 真正学会“记住自己做过什么”。完整文档与高级用法详见:Beads 官方文档。
项目信息
编程语言:Go|GitHub Star 数:21,736|开源协议:MIT|GitHub 项目地址
这不是又一个玩具 CLI,而是当前 AI 编程范式下缺失的关键拼图——用数据库思维解决智能体的健忘症,让每一次人机协作都真正可积累、可复盘、可传承。


