beads

Beads (br) 是一款专门为解决 AI 代理上下文易失性问题而设计的基于图形的问题追踪工具。与在对话压缩期间会重置的标准线性待办事项清单不同，Beads 为跨会话工作提供了持久的记忆。它专为任务具有复杂依赖性、阻碍并需要高保真状态恢复的长期软件工程项目而建。通过利用 Git 备份存储，它确保了项目的路线图、笔记和任务进度在不同的编码会话和团队成员之间保持同步和可存取。

• 实现了在对话压缩和上下文重置后仍能持续存在的持久记忆。

• 实作了基于图形的任务依赖性管理，以追踪阻碍因素并对复杂的工作流程进行排序。

• 与 Git 整合，允许将问题状态（基于 SQLite）导出为 JSONL 并通过版本控制进行追踪。

• 支持多用户团队同步，利用标准的 Git 工作流程。

• 通过提供更新状态、捕捉工作笔记和上下文恢复的结构化协议，促进会话交接。

• 作为专为 AI 代理设计的命令行界面 (CLI) 运行，使其能够自主管理自己的任务清单。

• 当工作跨越数天或多个会话，或者上下文对于在压缩期间不丢失至关重要时，请使用 Beads。

• 使用 br CLI 命令，例如 br ready 来寻找未被阻碍的工作，br update 来转换状态，以及 br sync 将变更提交到您的存储库。

• 务必使用 br dep add 命令定义依赖性以厘清操作顺序，请注意其方向性表示第二个参数必须先于第一个参数完成。

• 确保存储库中存在 .beads/ 目录；如果在新复制后丢失，请使用 br sync --import-only 重新填充数据库。

• 当任务边界模糊、包含研究组件，或需要对开发过程中做出的决策进行持久的历史追踪时，请优先选择 Beads 而非像 TodoWrite 这样的临时工具。