beads-issue-tracking

Track dependency-aware issues across multi-session projects with Git sync.

1|Updated Nov 1, 2025
One-click install
npx skills add https://github.com/shaneholloman/beads --skill beads-issue-tracking-shaneholloman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-issue-tracking
Source: https://github.com/shaneholloman/beads/tree/main/examples/claude-code-skill
Command: npx skills add https://github.com/shaneholloman/beads --skill beads-issue-tracking-shaneholloman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps manage complex, multi-session projects by providing a persistent, dependency-aware issue tracking system that survives AI context compaction.

Core Features & Use Cases

  • Persistent Issue Tracking: Issues and their relationships are stored locally and synced via Git, ensuring context is never lost.
  • Dependency Management: Track blockers, related tasks, parent-child hierarchies, and discovery origins to visualize project structure and automatically identify ready work.
  • Compaction Survival: Notes fields are designed for post-compaction recovery, allowing work to resume seamlessly after context windows are cleared.
  • Use Case: A developer working on a large feature spanning multiple weeks can use beads to track subtasks, dependencies, and design decisions, ensuring they can pick up exactly where they left off, even after significant time away or AI context resets.

Quick Start

Use the beads skill to check for ready work at the start of your session.

Frequently Asked Questions about beads-issue-tracking

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

FAQPage Schema
How do I track complex project issues across multiple AI sessions after context compaction?

Issue tracking across multiple AI sessions requires a persistent dependency graph that survives context compaction. This Skill stores issues and relationships locally, using notes fields designed for post-compaction recovery so you can resume work seamlessly after context windows are cleared.

How does dependency management identify unblocked tasks for agent workflows?

Dependency management tracks blockers, related tasks, and parent-child hierarchies to visualize project structure. By mapping these relationships, the system automatically identifies ready work, showing which tasks are unblocked and available to start during your current session.

Can I use Git to sync project memory and issue tracking data?

Git syncing for issue tracking is fully supported. Issues and their dependency relationships are stored locally and synced via Git, ensuring project memory and context are never lost across different development environments or when collaborating with team members.

What is the best way to manage multi-week feature development with persistent issue graphs?

Managing multi-week feature development benefits from a persistent issue graph that tracks subtasks, dependencies, and design decisions. This approach ensures you can pick up exactly where you left off, even after significant time away or AI context resets, by checking for ready work at session start.

Does this issue tracking system support proactive issue creation during project discovery?

Proactive issue creation during discovery is supported. As you explore the project, you can capture new issues on the fly, recording their discovery origins and relationships to ensure no newly identified tasks or dependencies are lost between sessions.

When do I need context persistence for issue tracking in software engineering?

Context persistence for issue tracking is needed when managing complex, multi-session projects in software engineering. It becomes essential when AI context windows are frequently cleared, requiring notes fields designed for post-compaction recovery to maintain project continuity and detailed session handoffs.