gastownhall/beads

Beads - A memory upgrade for your coding agent

解决的问题

Beads 为 AI Agent 提供持久化、结构化的记忆和问题追踪系统。它用具有依赖感知能力的图结构取代了非结构化的 Markdown 计划，防止 Agent 在长期任务中丢失上下文，并消除了杂乱无章的 TODO 列表的需求。

工作原理

Beads 使用版本控制的 SQL 数据库（由 Dolt 提供）来存储任务和记忆。它作为一个 CLI 工具运行，Agent 可以使用它来创建、认领和关闭任务，同时追踪依赖关系（例如：blocks, relates-to）。通过提供结构化的 JSON 输出以及一个可以将必要的流程上下文和持久化记忆注入 Agent 提示词的 bd prime 命令，它可以与各种 AI Agent（如 Claude Code, Codex, Factory.ai）集成。

适用对象

希望超越简单的文本文件进行任务管理，并为他们的 Agent 提供可靠的、版本控制的项目进度知识图谱的开发者和 AI Agent 编排者。

亮点

  • Dolt 驱动的存储： 使用具有单元级合并和原生分支功能的版本控制 SQL 数据库，实现无冲突的多 Agent 工作流。
  • Agent 优化： 具有 JSON 输出功能和“就绪”任务（即没有未解决阻碍任务的任务）的自动检测功能。
  • 语义记忆衰减： 包含压缩功能，通过总结旧的已完成任务来节省上下文窗口空间。
  • 灵活的部署： 支持嵌入式和基于服务器的存储模式，并且可以完全在没有 Git 的情况下运行。
  • 层级化任务： 通过层级 ID（例如 bd-a3f8.1.1）支持 Epic 和子任务。