beads

Track tasks and issues with dependency awareness using a Git-backed issue tracker.

24|6|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/johnlindquist/claude --skill beads
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads
Source: https://github.com/johnlindquist/claude/tree/main/skills/beads
Command: npx skills add https://github.com/johnlindquist/claude --skill beads

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires cargo, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates manual task tracking and project management overhead, providing git-backed issue management with sophisticated dependency tracking for complex workflows.

Quick Start

List all ready tasks with no blockers for the current project to see what can be worked on immediately.

Frequently Asked Questions about beads

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track tasks and issues with dependency awareness?

Track tasks and issues with dependency awareness using a git-backed issue tracker that shows which work is ready to start. The Skill provides commands to view ready tasks, create and update issues, manage dependencies between them, and organize work into epics, eliminating manual coordination overhead.

Can I use Git to persist my project management data?

Yes, this Skill uses Git as its backing store for all task and issue data. Everything persists in your repository with JSON-formatted output, enabling version control, collaboration, and automatic synchronization through optional git hooks.

How do I identify which tasks have no blockers and are ready to work on?

List all ready tasks by running the command to view work with no dependency blockers for your current project. The Skill filters tasks by status and dependency state, showing only work you can start immediately.

What's the best way to manage task dependencies in a complex project?

Manage task dependencies by creating issues with explicit dependency relationships and using the Skill's dependency tracking commands. It handles status transitions, priority handling, and labeling across dependent tasks, keeping your workflow organized without manual updates.

Do I need Cargo installed to use this task tracking tool?

Yes, Cargo is a required dependency for this Skill. Ensure it's installed in your environment before using the task tracking and issue management features.

Can I automate task synchronization with git hooks?

Yes, this Skill supports optional git hooks for automatic synchronization of tasks and issues. Set them up to keep your issue state aligned with repository changes without manual intervention.