斩获14.1k Star!AI智能体外挂记忆神器Beads开源,取代杂乱Markdown任务清单

智猩猩AI整理

编辑:没方

大家使用AI智能体时有没有这样的烦恼?昨天刚讨论完的方案,今天它却忘得一干二净。这是由于当前基于 Markdown 任务清单的智能体工作流存在根本性缺陷:

  • 版本混乱:AI 无法区分“昨天刚决定”与“三周前的头脑风暴”;

  • 缺乏关联:文档之间没有明确的依赖关系与优先级;

  • 上下文断层:每次会话都需要从头重新解释项目状态;

  • 更新滞后:手工维护的文档往往跟不上实际进展。

导致智能体给人感觉如同失忆一般,无法承接上下文,也无法自主推进复杂任务。

为此,今天要给大家介绍Steve Yegge大佬(曾任职于Geoworks、亚马逊、谷歌、Grab、Sourcegraph)开源项目Beads——专为 AI 智能体设计的外部记忆工具。它用具备依赖感知的图结构取代传统杂乱无章的 Markdown 任务清单,提供显式依赖管理、执行任务溯源、会话状态持久化、多智能体任务隔离分配与语义化审计追踪能力。该项目在github上已收获 14.1k stars。

图片
  • 项目地址:

    https://github.com/steveyegge/beads


01

项目介绍


传统 Markdown TODO 列表依赖人类的理解与上下文维护,而 Beads基于 Git 从底层重构了智能体任务管理范式,将当前工作进行结构化拆解,形成具备唯一ID、明确优先级、清晰依赖关系和完整审计日志的可寻址任务网络。Beads的核心设计包括:

(1)依赖关系形式化


传统任务管理依赖自然语言描述,要求使用者进行语义解析与上下文推断。Beads则将依赖关系以显式、结构化的数据进行存储与查询。用户可通过 bd ready — json 命令直接获取未被阻塞的可执行任务,无需人工解读文本。这种从“解释性 prose”到“可查询 structured data”的转变,显著降低了认知负荷,并为自动化决策提供了可靠输入。


(2)执行过程中的动态发现机制


传统方法仅将发现的新问题追加至扁平化的 TODO 列表中,导致上下文丢失。而Beads引入discovered-from 依赖类型,允许用户在创建新任务时明确其任务来源。由此构建的依赖图不仅记录任务间的逻辑关系,更映射了工作的真实演化路径,形成具有历史语义的任务网络,而非静态清单。


(3)会话持久化与上下文连续性


智能体受限于上下文窗口边界,传统工作流需要人工干预以维持任务状态连续性。Beads 基于Git持久化任务状态,使得智能体可在任意会话中通过标准查询命令( bd ready --json)即时恢复完整工作上下文,无需依赖用户重复提供历史信息。


(4)保障多智能体协同可行性


多智能体协作时,传统Markdown列表极易引发状态冲突与重复劳动问题Beads利用Git构建了一个共享的逻辑数据库。各智能体可实时查询任务状态(status: in_progress),并通过 --assignee 过滤器明确分工。这种基于显式状态与分配机制的协调策略,能够保障多智能体并行工作。


(5)可验证的操作审计日志


当任务状态变更时,传统 Markdown 仅能通过 git blame 查看行级文本变更,无法追溯语义化的状态流转,而Beads 会将其记录为带时间戳与操作者标识的事件日志,支持完整的语义级历史追溯。


02

使用方法


(1)安装beads


快速脚本:

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

npm:

npm install -g @beads/bd

Homebrew:

brew install beads

Go:

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

系统要求:Linux、FreeBSD、macOS 或 Windows。Beads 是只需安装一次即可随处使用的 CLI 工具。无需将此仓库克隆到项目中。


(2)快速启动

# 在项目中初始化cd your-projectbd init
#告知智能体echo "Use 'bd' for task tracking" >> AGENTS.md


指令 
功能
bd ready
未被阻塞的可执行任务
bd create "Title" -p 0
创建P0优先级任务
bd dep add <child> <parent>
关联任务 (blocks, related, parent-child)
bd show <id>
查看任务详情和审计记录

Beads 支持层级 IDs 


bd-a3f8 (Epic)

bd-a3f8.1 (Task)

bd-a3f8.1.1 (Sub-task)


隐身模式(Stealth Mode):运行 bd init --stealth ,即可在不向主仓库提交任何文件的情况下本地使用 Beads。


03

总结


Beads通过结构化依赖、执行任务溯源、会话持久化、多智能体协同机制与语义化审计追踪,构建了一个符合智能体认知特性的外部工作记忆系统。该系统不仅提升了任务执行效率,还为多智能体协作提供了可靠且可扩展的工程基础设施