beads

Track AI agent tasks with git-backed issue management.

22|1|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/itechmeat/llm-code --skill beads-itechmeat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads
Source: https://github.com/itechmeat/llm-code/tree/main/skills/beads
Command: npx skills add https://github.com/itechmeat/llm-code --skill beads-itechmeat

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Beads provides a distributed, git-backed issue tracker that gives AI agents a persistent memory of tasks, dependencies, and delivery checkpoints across sessions and repositories.

Core Features & Use Cases

  • Hash-based IDs to prevent merge conflicts and enable traceable task history.
  • Dependency graphs, molecules & gates to model complex workflows with clear QA checkpoints.
  • Git-based sync to coordinate across teams and worktrees, with support for GitLab/Linear/Jira integrations.
  • Agent-ready output & plugins for seamless integration with agents and tooling.

Quick Start

Install Beads and start planning in your repo:

  • Install: brew install steveyegge/beads/bd
  • Or: curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash Initialize in your repo: bd init Tell your agent about beads: echo "Use 'bd' for task tracking" >> AGENTS.md

Frequently Asked Questions about beads

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

FAQPage Schema
How do I maintain persistent task memory for AI agents across sessions?

Git-backed task tracking maintains persistent task memory for AI agents by storing issues, dependencies, and delivery checkpoints directly in your repository, ensuring continuity across sessions and worktrees.

How do I prevent merge conflicts in a distributed issue tracker?

Hash-based IDs prevent merge conflicts in a distributed issue tracker by generating unique, traceable task identifiers that avoid sequential number collisions across branches and cross-repo sync.

Can I model complex multi-agent workflows with dependency graphs and gates?

Dependency graphs, molecules, and gates model complex multi-agent workflows by defining task relationships and establishing clear QA checkpoints for delivery validation.

Does this git-backed task tracker integrate with external tools like Jira and Linear?

Git-based sync integrates with external tools like GitLab, Linear, and Jira through plugins, enabling coordinated task tracking and dependency management across teams and repositories.

What is the best way to track dependencies across multiple worktrees?

Git-based sync provides the best way to track dependencies across multiple worktrees by coordinating task states and dependency graphs directly through repository commits and cross-repo synchronization.

How do I set up an AI agent to use git-backed task tracking in my repo?

Initialize git-backed task tracking in your repo using the init command, then instruct your agent to use the task tracker by adding the directive to your agent configuration file.