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.