beads-task-tracker

Manage multi-session coding projects with a git-versioned, dependency-aware task tracker.

41|3|Updated Jan 2, 2026
One-click install
npx skills add https://github.com/tdimino/claude-code-minoan --skill beads-task-tracker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-task-tracker
Source: https://github.com/tdimino/claude-code-minoan/tree/main/skills/core-development/beads-task-tracker
Command: npx skills add https://github.com/tdimino/claude-code-minoan --skill beads-task-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the "amnesia problem" for AI agents by providing a persistent, git-versioned, dependency-aware task tracking system, ensuring context is maintained across long-horizon projects and multiple agent sessions.

Core Features & Use Cases

  • Dependency Management: Define and visualize task dependencies (blocks, parent-child, discovered-from).
  • Intelligent Work Prioritization: Query for "ready" work that has no open blockers, ensuring agents always pick up actionable tasks.
  • Contextual Discovery: Seamlessly create and link new tasks discovered during implementation.
  • Use Case: When working on a large software feature that spans days or weeks, Beads ensures that each agent session starts with a clear understanding of what tasks are unblocked and ready for development, preventing context loss and redundant planning.

Quick Start

Initialize Beads in your project by running bd init in your terminal.

Frequently Asked Questions about beads-task-tracker

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

FAQPage Schema
How do I maintain task tracking context for AI agents across multiple coding sessions?

Task tracking context is maintained across multiple sessions using a git-versioned, queryable database that stores dependencies and statuses. This prevents context loss by allowing new agent sessions to query unblocked, ready work immediately.

How do I manage task dependencies and blockers in a complex software project?

Task dependencies are managed by defining relationships like blocks and parent-child links within the tracker. You query for ready work that has no open blockers, ensuring agents always pick up actionable tasks first.

What is the best way to prioritize coding tasks for an AI agent workflow?

Task prioritization is achieved by querying the tracker for ready work that has no open blockers. This intelligent work prioritization ensures the agent always selects actionable tasks, preventing redundant planning.

Does this task tracker work with Git for versioning project progress?

Yes, the task tracker integrates directly with Git for versioning project progress. This provides a persistent, dependency-aware history of issue creation, status updates, and discovered tasks across long project horizons.

How do I initialize task tracking in my existing project directory?

You initialize the task tracker in your project directory by running the `bd init` command in your terminal. This sets up the persistent, git-versioned database required to manage dependencies and track progress.