Beads Task Tracker

Overview

Beads is a git-versioned, dependency-aware issue tracker designed specifically for AI coding agents. It solves the "amnesia problem" where agents lose context between sessions by providing a persistent, queryable task database that agents can use to orient themselves, find ready work, and track dependencies across long-horizon projects.

Use Beads when:

• Working on projects with multiple interconnected tasks
• Tasks span multiple agent sessions (>10 minutes)
• Need to track what work is blocked vs. ready
• Discovering new work during implementation that should be captured
• Multiple agents or machines are working on the same codebase
• Want to avoid the "markdown plan swamp" where plans become stale and disorganized

Installation Check

Before using Beads, verify the bd command is installed: