beads

Manage AI agent tasks and dependencies with a git-native issue tracking system.

1|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/mapachekurt/mapache-skills --skill beads-mapachekurt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads
Source: https://github.com/mapachekurt/mapache-skills/tree/main/skills/beads
Command: npx skills add https://github.com/mapachekurt/mapache-skills --skill beads-mapachekurt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a robust, git-native system for tracking issues and managing AI agent workflows, ensuring persistence and queryability of agent tasks and their dependencies.

Core Features & Use Cases

  • Persistent Memory: Stores issue data in a git repository, enabling version control and history.
  • Dependency Management: Manages complex relationships between issues, forming a Directed Acyclic Graph (DAG).
  • Cross-Agent Compatibility: Designed to work with various AI agents, including those using MCP (e.g., Claude/Antigravity).
  • Use Case: Track the development of a new feature by creating issues for each task, linking them by dependencies, and using the skill to query progress or identify bottlenecks.

Quick Start

Use the beads skill to create a new issue with the title 'Implement user authentication'.

Frequently Asked Questions about beads

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

FAQPage Schema
How do I track AI agent tasks and dependencies in a git repository?

You can track AI agent tasks and dependencies in a git repository using a git-native issue tracking system that stores data as a persistent, queryable Directed Acyclic Graph. This provides version control and history for all workflow management operations.

What is a DAG-based issue tracking system for AI workflows?

A DAG-based issue tracking system for AI workflows manages complex relationships between issues by forming a Directed Acyclic Graph. It ensures persistent memory and queryability of agent tasks across different AI agents and platforms.

How do I manage dependencies between issues for AI agents?

To manage dependencies between issues for AI agents, you create issues for each task and link them by dependencies. The system forms a Directed Acyclic Graph that allows you to query progress or identify bottlenecks in the workflow.

Can I use MCP server for issue tracking with Claude or Antigravity agents?

Yes, you can use an MCP server for issue tracking with Claude or Antigravity agents. The system is designed for cross-agent compatibility, integrating with both CLI and MCP server for operational commands and data access.

Does git-native issue tracking work across different AI agent platforms?

Git-native issue tracking works across different AI agent platforms by storing issue data in a git repository. This cross-agent compatibility ensures persistent, queryable task and dependency management regardless of the specific AI platform used.

What are the limitations of storing AI workflow dependencies in git?

The metadata does not specify explicit limitations of storing AI workflow dependencies in git. However, the system requires integration with a CLI and MCP server to facilitate operational commands and data access for the DAG storage.