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.