beads

Installation
SKILL.md

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.

Overview

bd (beads) replaces markdown task lists with a dependency-aware graph stored in git. Unlike TodoWrite (session-scoped), bd persists across compactions and tracks complex dependencies.

Key Distinction:

  • bd: Multi-session work, dependencies, survives compaction, git-backed
  • TodoWrite: Single-session tasks, linear execution, conversation-scoped

Core Capabilities:

  • πŸ“Š Dependency Graphs: Track what blocks what (blocks, parent-child, discovered-from, related)
  • πŸ’Ύ Compaction Survival: Tasks persist when conversation history is compacted
  • πŸ™ Git Integration: Issues versioned in .beads/issues.jsonl, sync with bd sync
  • πŸ” Smart Discovery: Auto-finds ready work (bd ready), blocked work (bd blocked)
  • πŸ“ Audit Trails: Complete history of status changes, notes, and decisions
  • 🏷️ Rich Metadata: Priority (P0-P4), types (bug/feature/task/epic), labels, assignees
Related skills

More from ynulihao/agentskillos

Installs
7
GitHub Stars
388
First Seen
Feb 10, 2026