beads

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Beads - Persistent Task Memory for AI Agents

Beads - AI Agent的持久化任务内存

Graph-based issue tracker that survives conversation compaction.
基于图结构的问题追踪工具,可在对话压缩后保留任务信息。

Overview

概述

bd (beads) replaces markdown task lists with a dependency-aware graph stored in git.
Key Distinction:
  • bd: Multi-session work, dependencies, survives compaction, git-backed
  • TodoWrite: Single-session tasks, linear execution, conversation-scoped
Decision Rule: If resuming in 2 weeks would be hard without bd, use bd.
bd(beads) 会将Markdown任务列表替换为存储在Git中的、支持依赖关系的图结构。
核心区别
  • bd:支持多会话工作、依赖关系管理,可在对话压缩后保留数据,基于Git实现
  • TodoWrite:仅支持单会话任务、线性执行,仅在当前对话范围内有效
决策规则:如果两周后不使用bd就难以恢复工作,那么就选择使用bd。

Prerequisites

前置条件

  • bd CLI: Version 0.34.0+ installed and in PATH
  • Git Repository: Current directory must be a git repo
  • Initialization:
    bd init
    run once (humans do this, not agents)
  • bd CLI:已安装0.34.0及以上版本,并配置在PATH中
  • Git仓库:当前目录必须是一个Git仓库
  • 初始化:需执行一次
    bd init
    (由人工操作,而非Agent)