beads

Track multi-session work items with dependency relationships and persistent notes.

5|Updated Oct 27, 2025
One-click install
npx skills add https://github.com/jbabin91/autocomplete-rs --skill beads-jbabin91
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: beads
Source: https://github.com/jbabin91/autocomplete-rs/tree/main/.claude/skills/beads
Command: npx skills add https://github.com/jbabin91/autocomplete-rs --skill beads-jbabin91

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Beads provides a structured, persistent memory for long-running, multi-session work by tracking items with dependencies and ensuring state survives compaction.

Core Features & Use Cases

  • Beads-based issue tracking with blocks, related, parent-child, and discovered-from dependencies.
  • Session-persistent notes and NEXT actions; supports compaction recovery.
  • Supports cross-session collaboration, milestones, and change history.

Quick Start

Start a session by checking what work is ready, then create an epic with beads and begin tracking progress with NEXT steps.

Frequently Asked Questions about beads

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

FAQPage Schema
How do I track persistent context and dependencies for multi-session work across compaction events?▼

You can track persistent context for multi-session work by using beads to model dependencies like blocks, parent-child, and related items, ensuring workflow state survives compaction events. This structured memory keeps long-running complex projects coordinated across sessions.

What is the best way to manage issue tracking for complex projects spanning multiple days?▼

Issue tracking for complex projects spanning multiple days is managed by creating epics with beads, tracking progress with NEXT steps, and logging session-persistent notes. This approach handles blockers, side quests, and cross-team collaboration effectively.

Can I coordinate cross-team collaboration and milestones without losing session notes?▼

Yes, cross-team collaboration and milestones are supported alongside session-persistent notes. The system maintains change history and session-level notes, allowing coordinated work to continue seamlessly even after compaction recovery.

How do I start tracking progress with NEXT steps and dependency modeling?▼

To start tracking progress, check what work is ready, then create an epic with beads and begin defining NEXT actions. Dependency modeling allows you to track blocks, related items, parent-child relationships, and discovered-from links.

Does dependency modeling support parent-child and related links for workflow tracking?▼

Yes, dependency modeling supports blocks, related, parent-child, and discovered-from links for comprehensive workflow tracking. This ensures that all task relationships are mapped and preserved during compaction events.

Why does workflow tracking fail after compaction and how do I recover session state?▼

Workflow tracking fails after compaction because standard context is lost, but you can recover session state by using compaction-resilient beads. These beads persist NEXT actions and dependency models, allowing work to resume without losing prior progress.