Beads / bd
为 AI 编程代理准备的 Git 友好图任务追踪器，让 Codex、Claude Code、Cursor 等长期任务不丢上下文
Beads 是什么
Beads（命令行名 bd）是给 AI 编程代理用的分布式图任务追踪器。它不是另一个普通 TODO 应用，而是把任务、依赖、阻塞关系、决策背景写成结构化 issue，让 agent 在长周期开发中可以恢复上下文。
最适合的场景：一个项目要连续改几天，涉及多个文件、多个子任务、多个 agent 或多次上下文切换。传统 Markdown 计划很容易过期或散落，Beads 用图结构表达任务关系，下一轮 agent 可以先读取当前 ready/blocking 状态再继续。
最适合的场景：一个项目要连续改几天，涉及多个文件、多个子任务、多个 agent 或多次上下文切换。传统 Markdown 计划很容易过期或散落，Beads 用图结构表达任务关系，下一轮 agent 可以先读取当前 ready/blocking 状态再继续。
为什么它适合 AI Coding Agent
AI 编程代理最常见的问题不是不会写代码，而是长任务中忘记目标：上一轮已经做了什么、哪个任务被阻塞、为什么先改 A 后改 B。Beads 把这些状态从聊天上下文挪到仓库里的结构化任务系统。
对 Codex CLI、Claude Code、Cursor、OpenClaw 这类工具，Beads 可以作为“任务记忆层”：代码还是 agent 写，计划和依赖由 bd 记录。这样换模型、换 session、换人接手时，项目不会只依赖聊天记录。
对 Codex CLI、Claude Code、Cursor、OpenClaw 这类工具，Beads 可以作为“任务记忆层”：代码还是 agent 写，计划和依赖由 bd 记录。这样换模型、换 session、换人接手时，项目不会只依赖聊天记录。
快速安装和使用
基本流程是：先安装 bd CLI，然后在你的项目根目录运行 bd init。之后可以用 bd setup codex 或 bd setup claude 生成适配不同 agent 的工作流说明。
典型命令：curl 安装脚本 → cd your-project → bd init → bd setup codex。不要把 Beads 仓库克隆到你的项目里，它是系统级 CLI，初始化的是你自己的项目任务数据库。
典型命令：curl 安装脚本 → cd your-project → bd init → bd setup codex。不要把 Beads 仓库克隆到你的项目里，它是系统级 CLI，初始化的是你自己的项目任务数据库。
Beads 适合谁
适合：经常用 AI agent 改代码的人、一个项目会跨多天推进的人、需要多个 agent/多人协作的人、以及不想把计划散落在 AGENTS.md、TODO.md、聊天记录里的开发者。
不适合：只做一次性小改动、完全不使用 coding agent、或者团队已经强依赖 Linear/Jira 且不想引入仓库内任务状态的项目。
不适合：只做一次性小改动、完全不使用 coding agent、或者团队已经强依赖 Linear/Jira 且不想引入仓库内任务状态的项目。
替代方案怎么选
GitHub Issues 更适合公开项目和人类协作；Linear 更适合产品团队排期；Task Master AI 更偏 AI 生成任务拆解；Markdown TODO 最轻，但最容易失控。
Beads 的优势在于“agent 原生”：它把依赖图、ready/blocking 状态和仓库同步放在第一位。我们的建议是：个人/小团队 AI 开发项目用 Beads；对外路线图继续用 GitHub Issues 或 Linear。
Beads 的优势在于“agent 原生”：它把依赖图、ready/blocking 状态和仓库同步放在第一位。我们的建议是：个人/小团队 AI 开发项目用 Beads；对外路线图继续用 GitHub Issues 或 Linear。