How do I visualize the relationships between my tasks?

Use the 'bd dep tree' command followed by an issue ID to see a visual representation of how tasks block or relate to one another.

What makes Beads different from other issue trackers?

Beads focuses on dependency-aware tracking, allowing you to chain issues together and identify exactly what work is unblocked and ready for an AI agent or developer to start.

Is Beads specifically for AI agents?

While designed to help AI agents identify 'ready' work and avoid duplicating effort, it is a fully functional CLI tool that is equally powerful for human developers.

How does Beads synchronize with my team?

It automatically exports changes to JSONL files and imports them when newer versions are detected, allowing you to sync your issue database via standard Git operations like pull and push.

Beads Issue Tracker

Name: Beads Issue Tracker
Author: plurigrid

byplurigrid

•

Collaboration Tools

Manages project issues with a lightweight, dependency-aware tracker optimized for AI agents and developer workflows.

Beads (bd) is a specialized issue tracker designed to facilitate complex development tasks by treating issues as interconnected "beads" in a chain. It excels at handling deep dependency trees, allowing users to visualize task hierarchies and identify work that is truly ready to be tackled. Built with AI agents in mind, Beads provides specific commands like 'bd ready' to surface unblocked tasks and features automatic Git synchronization via JSONL files, ensuring that both human developers and AI assistants stay aligned without manual overhead or external database dependencies.

Key Features

018 GitHub stars

02First-class dependency management with support for blocking, related, and parent-child relationships.

03Built-in dependency tree visualization and circular dependency detection.

04Agent-optimized 'ready' command to instantly identify unblocked tasks available for execution.

05Automatic Git synchronization using debounced JSONL exports for seamless team collaboration.

06Programmatic integration via JSON flags for automated workflows and AI parsing.

Use Cases

01Managing complex software roadmaps where tasks have strict sequential dependencies.

02Maintaining a lightweight, local-first issue tracking system that syncs directly with Git repositories.

03Coordinating AI agent workflows by providing a structured, machine-readable task queue.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add plurigrid/asi beads-issue-tracker

For use in Claude.ai and ChatGPT

Download Skill