bd-issues

Manage local issue tracking with dependency management via bd CLI commands.

1|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/jack-michaud/ephemeral-environments --skill bd-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bd-issues
Source: https://github.com/jack-michaud/ephemeral-environments/tree/main/.claude/skills/bd-issues
Command: npx skills add https://github.com/jack-michaud/ephemeral-environments --skill bd-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

bd provides a lightweight, local issue tracker for developers and teams, enabling persistent tracking of tasks, bugs, and dependencies without external services.

Core Features & Use Cases

  • Create and manage issues (task, bug, feature) via the bd CLI.
  • Define dependencies between issues to surface blockers and track related work.
  • Store data locally in a .beads directory with optional git synchronization for team collaboration.

Quick Start

Install bd, initialize your beads environment, and start creating and tracking issues using the bd commands.

Frequently Asked Questions about bd-issues

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

FAQPage Schema
How do I track local issues and task dependencies without external services?

You can track local issues using a CLI that stores data in a .beads directory. It supports creating tasks, bugs, and features while managing dependencies, making it suitable for solo projects or small teams needing persistent tracking.

Can I sync local issue tracking with git for team collaboration?

Yes, local issue tracking supports optional git synchronization for team collaboration. Data stored in the .beads directory can be synced via git, allowing small teams to share and update tasks and dependencies seamlessly.

What is the best lightweight issue tracker for solo developer projects?

A lightweight local issue tracker operates entirely via a CLI and stores data in a .beads directory. It distinguishes itself from external platforms by providing dependency management and persistent tracking without external services or heavy infrastructure.

How do I create and manage project tasks using a CLI?

You can create and manage project tasks using bd CLI commands like bd create, bd list, bd update, and bd close. These commands allow you to define issues, set dependencies to surface blockers, and update task statuses directly from the terminal.

Does local issue tracking work for small teams needing dependency management?

Yes, local issue tracking is designed for solo projects or small teams needing persistent issue tracking with dependency management. It allows you to define dependencies between issues to surface blockers and track related work efficiently.