beads

Automates issue tracking and dependency management using the Beads (bd) CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Beads provides a lightweight, command-line driven system to manage issues, track progress, and model dependencies within software projects, reducing context switching and increasing team visibility.

Core Features & Use Cases

  • bd ready — identify tasks with no blockers and surface them for action.
  • bd show / bd list — view issue details and organize work by type (task, bug, feature, epic, chore) and priority.
  • bd create / bd update / bd close — create new issues, update their status, or close them when done.
  • bd dep / dependency trees — declare and visualize blocking relationships to keep work flowing.
  • Sync & workflow: keep local records in sync with the remote state and quickly find ready or blocked tasks.

Quick Start

Use beads to create, query, update, or close issues with the bd CLI. For example: bd create --title "Setup CI" --type task --description "Configure CI pipeline" --json

Frequently Asked Questions about beads

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

FAQPage Schema
How do I manage software dependencies and issue tracking from the command line?

The Beads CLI provides a lightweight, command-line driven system to manage issues and model dependencies. It reduces context switching by allowing teams to track tasks, bugs, and features directly from the terminal across multiple projects.

How do I identify blocked tasks and ready issues in my project?

You can identify blocked tasks and ready issues using the 'bd ready' command to surface tasks with no blockers, and 'bd blocked' to view stalled work. This helps keep work flowing by visualizing dependency trees and blocking relationships.

What is the best way to create and update issues across multiple software projects?

The best way to create and update issues across multiple projects is using 'bd create' and 'bd update' commands. You can generate new tasks, bugs, or features, update their status, and close them using 'bd close' when completed.

Do I need to install the Beads CLI to use this issue tracking system?

Yes, you need the Beads CLI installed to use this issue tracking system. The Skill automates commands like 'bd show', 'bd list', and 'bd sync', requiring the local CLI environment to interact with remote state and manage dependencies.

How do I keep local issue tracking records in sync with the remote state?

You keep local issue tracking records in sync with the remote state using the 'bd sync' command. This ensures local records match the remote state, allowing teams to quickly find ready or blocked tasks and maintain progress visibility.

Can I organize and view software issues by type and priority?

Yes, you can organize and view software issues by type and priority using 'bd show' and 'bd list' commands. These commands allow you to view issue details and organize work by task, bug, feature, epic, or chore categories.