How does Beads handle merge conflicts?

It uses append-only JSONL files and unique hash-based IDs to significantly reduce the likelihood of conflicts; standard git merge tools can be used if they do occur.

How do I see tasks that are ready to be worked on?

You can use the 'bd ready' command to instantly filter and list all tasks that have no unresolved dependencies or active blockers.

What makes Beads different from GitHub Issues?

Beads stores tasks directly in your git repository as JSONL files, allowing for offline access, branch-specific task states, and superior integration with AI agents.

What is stealth mode in Beads?

Stealth mode (bd init --stealth) allows you to use Beads for local task tracking and dependency management without committing data to the repository or pushing to remotes.

Can I use Beads with AI agents?

Yes, Beads is specifically designed for AI integration, offering a --json flag for all commands to provide machine-readable task data for programmatic processing.

Beads Distributed Issue Tracker

Name: Beads Distributed Issue Tracker
Author: vinnie357

byvinnie357

•

Herramientas de Colaboración

Manages tasks and dependencies using a git-backed, hash-based distributed issue tracker optimized for AI workflows and parallel development.

Beads is a developer-centric tool that treats issues as a core part of the repository, storing tasks as JSONL files within a .beads directory. It provides a robust framework for tracking complex task hierarchies and dependency graphs, ensuring that developers and AI agents always know which tasks are 'ready' to be worked on. By utilizing hash-based IDs and append-only storage, Beads minimizes merge conflicts in distributed environments, making it ideal for teams running multi-branch parallel workflows and those integrating autonomous AI coding agents into their development cycle.

Características Principales

01Machine-readable JSON output for seamless AI agent integration

02Git-native task storage using version-controlled JSONL files

03Collision-resistant hash-based task identifiers

045 GitHub stars

05Automated dependency tracking with 'bd ready' query logic

06Support for hierarchical task relationships (Epics, Stories, Tasks)

Casos de Uso

01Creating an automated task queue for autonomous AI coding agents

02Managing project dependencies and blockers directly within the source code

03Maintaining task context across parallel feature branches and distributed teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add vinnie357/claude-skills beads

For use in Claude.ai and ChatGPT

Download Skill