Manages complex task dependencies for AI agents using a lightweight, Git-synced issue tracking system.
Beads (bd) is a specialized issue tracker designed to streamline AI-supervised workflows by treating tasks as interdependent chains. It solves the problem of agents duplicating effort or working out of order by providing first-class dependency support and a 'ready' command that surfaces only unblocked work. With automatic Git synchronization via JSONL files and programmatic JSON output, Beads allows AI agents to autonomously discover, log, and track work progress while staying perfectly in sync with the development team's local environment.
Key Features
01Programmatic-friendly CLI with JSON flags for seamless AI agent integration
02First-class dependency tracking with 'blocks', 'related', and 'parent-child' relationships
03Intelligent 'ready' command to identify open tasks with no blocking dependencies
04Visual dependency tree rendering and circular dependency detection
05Automatic Git synchronization using debounced JSONL export and import
068 GitHub stars
Use Cases
01Maintaining a decentralized issue tracker that lives directly within your Git repository
02Empowering AI agents to autonomously create and track sub-tasks discovered during coding
03Organizing multi-step feature development where specific tasks must be completed before others
