Beads

Graph-based task tracker that survives conversation compaction.

When to Use

Use bd (not TodoWrite) when:

• Context needed across sessions or after compaction
• Tasks have blockers/dependencies

Session Start

bd ready                              # Find unblocked tasks
bd show <id>                          # Get context
bd update <id> --status in_progress   # Start work

Common Commands

bd create "Title" -p 1                # Create task (priority 0-4)
bd update <id> --notes "Progress"     # Add notes (survives compaction)
bd close <id> --reason "Done"         # Complete task
bd dep add <child> <parent>           # Add dependency
bd sync                               # Sync with git remote

Notes Format

COMPLETED: Specific deliverables
IN PROGRESS: Current state + next step
BLOCKERS: What's preventing progress

Use bd --help or see references/examples.md for all commands.