鱼皮AI导航
鱼皮AI导航
  • 主页
  • 社区
  • AI工具
  • AI知识库
  • AI提示词
  • MCP
  • Skills
  • AI学习资源
  • AI资讯
  • GitHub开源
登录/注册

beads

支持跨会话的复杂任务管理与依赖跟踪,通过版本化存储保障上下文在对话压缩后仍可恢复,适用于多阶段、有阻塞或需团队协作的长期工作,确保任务状态与进展持续同步。

商业与营销开发运维
访问 GitHub
文档Skills.MD
name
beads
description
Git-backed issue tracker for multi-session work with dependencies and persistent memory across conversation compaction. Use when work spans sessions, has blockers, or needs context recovery after compaction.
allowed-tools
Read,Bash(bd:*)
version
0.47.1
author
Steve Yegge <https://github.com/steveyegge>
license
MIT

Beads - Persistent Task Memory for AI Agents

Graph-based issue tracker that survives conversation compaction. Provides persistent memory for multi-session work with complex dependencies.

bd vs TodoWrite

bd (persistent)TodoWrite (ephemeral)
Multi-session workSingle-session tasks
Complex dependenciesLinear execution
Survives compactionConversation-scoped
Git-backed, team syncLocal to session

Decision test: "Will I need this context in 2 weeks?" → YES = bd

When to use bd:

  • Work spans multiple sessions or days
  • Tasks have dependencies or blockers
  • Need to survive conversation compaction
  • Exploratory/research work with fuzzy boundaries
  • Collaboration with team (git sync)

When to use TodoWrite:

  • Single-session linear tasks
  • Simple checklist for immediate work
  • All context is in current conversation
  • Will complete within current session

Prerequisites

▼
bash
复制代码
bd --version # Requires v0.47.0+
  • bd CLI installed and in PATH
  • Git repository (bd requires git for sync)
  • Initialization: bd init run once (humans do this, not agents)

CLI Reference

Run bd prime for AI-optimized workflow context (auto-loaded by hooks). Run bd <command> --help for specific command usage.

Essential commands: bd ready, bd create, bd show, bd update, bd close, bd sync

Session Protocol

  1. bd ready — Find unblocked work
  2. bd show <id> — Get full context
  3. bd update <id> --status in_progress — Start work
  4. Add notes as you work (critical for compaction survival)
  5. bd close <id> --reason "..." — Complete task
  6. bd sync — Persist to git (always run at session end)

Advanced Features

FeatureCLIResource
Molecules (templates)bd mol --helpMOLECULES.md
Chemistry (pour/wisp)bd pour, bd wispCHEMISTRY_PATTERNS.md
Agent beadsbd agent --helpAGENTS.md
Async gatesbd gate --helpASYNC_GATES.md
Worktreesbd worktree --helpWORKTREES.md

Resources

ResourceContent
BOUNDARIES.mdbd vs TodoWrite detailed comparison
CLI_REFERENCE.mdComplete command syntax
DEPENDENCIES.mdDependency system deep dive
INTEGRATION_PATTERNS.mdTodoWrite and tool integration
ISSUE_CREATION.mdWhen and how to create issues
MOLECULES.mdProto definitions, component labels
PATTERNS.mdCommon usage patterns
RESUMABILITY.mdCompaction survival guide
STATIC_DATA.mdDatabase schema reference
TROUBLESHOOTING.mdError handling and fixes
WORKFLOWS.mdStep-by-step workflow patterns
AGENTS.mdAgent bead tracking (v0.40+)
ASYNC_GATES.mdHuman-in-the-loop gates
CHEMISTRY_PATTERNS.mdMol vs Wisp decision tree
WORKTREES.mdParallel development patterns

Full Documentation

  • bd prime: AI-optimized workflow context
  • GitHub: github.com/steveyegge/beads
商业与营销
开发运维

快捷安装

复制到终端去安装 Skill

npxskillsaddsteveyegge/beads--skill"beads"
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
🔥热门工具
朱雀AI检测朱雀AI检测
朱雀AI检测助手朱雀AI检测助手
LovartLovart
老鱼简历老鱼简历
WritePass官网WritePass官网
面多多面多多
CursorCursor
星月写作星月写作
朱雀AI检测助手朱雀AI检测助手
零感AI零感AI
Skills 推荐
retrieving-developer-knowledge
retrieving-developer-knowledge 用于搜索、获取和整合 Google 官方开发者文档,覆盖 Google Cloud、AI/Gemini、Android、Chrome、Web、Flutter、Go、Firebase 等平台,适用于查询 gcloud CLI 命令、API 语法、IAM 权限或架构对比等场景。
diff-intake
diff-intake 读取 PR 或分支差异,生成结构化 YAML 变更摘要,用于下游 analytics instrumentation 技能。适用于用户提交 PR 链接、分支对比或原始 diff 后需理解变更内容、评估分析覆盖或启动埋点流程的场景。
load-balancer-configurator
根据用户需求自动生成各类负载均衡器的生产级配置,覆盖 ALB、NLB、Nginx 和 HAProxy 等主流类型,适配不同协议、端口、健康检查及后端服务拓扑,支持直接集成到基础设施即代码流程中。
definition-of-done-generator
自动生成项目完成标准的规范定义与配置文件,提供符合企业级工作流要求的最佳实践指导,输出可直接投入生产环境的代码和验证结果,适用于需要标准化流程审批、合规审查及跨系统集成的复杂项目管理场景。
implement
实现 Linus Dashboard 的功能开发与集成,基于 TypeScript 和 Python 构建前后端组件,遵循严格的代码规范与架构模式,完成视图、卡片、服务及传感器等模块的创建与验证,确保高质量交付并兼容 Home Assistant 生态。