beads

Track issues with git-backed persistence and four dependency types across sessions.

3|2|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/tysonthomas9/loomcli --skill beads-tysonthomas9
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads
Source: https://github.com/tysonthomas9/loomcli/tree/main/third_party/beads/claude-plugin/skills/beads
Command: npx skills add https://github.com/tysonthomas9/loomcli --skill beads-tysonthomas9

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Beads provides persistent, git-backed issue tracking to coordinate multi-session work, preserving decisions, context, and dependencies across conversation compaction.

Core Features & Use Cases

  • Graph-based dependency management (blocks, related, parent-child, discovered-from) that keeps work moving without losing context
  • Git-backed persistence across compaction to survive session boundaries and restarts
  • Clear integration points for advanced workflows (bd prime, Molecules, Wisps, and session handoffs) to orchestrate end-to-end projects
  • Maintainer-friendly resources and detailed workflow guidance to coordinate cross-skill collaboration

Quick Start

Describe the current work, then create a beads issue and begin tracking the immediate actions with TodoWrite for this session.

Frequently Asked Questions about beads

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

FAQPage Schema
How do I preserve task context across multiple conversation sessions after compaction?

To preserve task context across multiple conversation sessions after compaction, use git-backed issue tracking to store decisions, dependencies, and progress notes that survive session boundaries and restarts.

How do I track complex task dependencies in a multi-session workflow?

Track complex task dependencies in a multi-session workflow by enforcing four dependency types: blocks, related, parent-child, and discovered-from, ensuring work moves forward without losing context.

What is the best way to manage persistent issue tracking for AI conversations?

The best way to manage persistent issue tracking for AI conversations is applying git-backed persistence to maintain decisions and context, preventing knowledge loss during session compaction.

Does git-backed persistence work for coordinating cross-skill collaboration?

Yes, git-backed persistence works for coordinating cross-skill collaboration by providing integration points for advanced workflows and session handoffs to orchestrate end-to-end projects.

How do I start tracking immediate actions after creating an issue?

To start tracking immediate actions after creating an issue, describe the current work, create the issue, and begin tracking the immediate actions using a todo tool for that session.