用途：bd（beads）是面向跨会话工作的图结构议题跟踪器，用于在对话历史被压缩或会话结束后仍保留工作上下文。资料建议：多会话、跨天或跨压缩周期的工作，存在阻塞、前置条件或层级结构的复杂依赖，边界模糊的知识型工作（战略文档、研究），可能中断主任务的探索性支线，以及需要数周后恢复完整上下文的项目记忆，使用 bd；单会话内可完成、线性无分支、信息已在对话中的简单清单，使用 TodoWrite。判断标准是：若两周后仅靠浏览 markdown 难以恢复工作，则用 bd。
主要能力：支持创建、更新、关闭和查询议题，字段包括 description（创建时固定的问题陈述）、design（方案与架构决策）、acceptance-criteria（可勾选交付清单）、notes（会话交接，按 COMPLETED/IN_PROGRESS/BLOCKERS/KEY DECISIONS/NEXT 格式书写）、status（open→in_progress→closed）、priority（0 最高，3 最低）。依赖类型有 blocks、related、parent-child、discovered-from 四种。所有命令支持 --json 输出。数据库自动发现：优先使用当前项目的 .beads/*.db，否则回退到 ~/.beads/default.db，也可用 --db 指定绝对路径。
使用方式：会话开始时运行 bd ready --json 查看可做工作，bd list --status in_progress --json 查看进行中工作，再用 bd show <issue-id> 读取 notes；无就绪项时用 bd blocked --json 查看阻塞。常用命令包括 bd create "标题"（标题与描述需加双引号）、bd update issue-123 --status in_progress、bd close issue-123 --reason "..."、bd dep add A B --type parent-child。建议在上下文不足、token 用量超过 70%、达到里程碑、遇到阻塞或切换任务时及时更新 notes。
限制：资料未提供安装方式、收费、平台支持与效果数据；关闭的议题仍保留在数据库中而非删除。具体决策标准、工作流与依赖细节需查阅其 references 目录下的文档。