beads

Track multi-session work with dependency graphs and git-backed persistence.

223|23|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/ReinaMacCredy/maestro --skill beads-reinamaccredy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads
Source: https://github.com/ReinaMacCredy/maestro/tree/main/skills/beads
Command: npx skills add https://github.com/ReinaMacCredy/maestro --skill beads-reinamaccredy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes file-beads (resource) and review-beads (resource) components.

What problem does it solve?

This Skill eliminates the frustration of lost work and forgotten decisions by providing persistent memory that survives compaction cycles.

Core Features & Use Cases

  • Multi-Session Work Tracking: Maintains complete context and dependency graphs for work spanning days or weeks.

Quick Start

Run 'bd ready' to see available work and automatically resume where you left off.

Frequently Asked Questions about beads

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

FAQPage Schema
How do I track complex work across multiple sessions without losing context?

Beads tracks multi-session work using dependency graphs and persistent memory that survives conversation compaction. Run 'bd ready' to resume where you left off, maintaining complete context for tasks spanning days or weeks with blockers and dependencies intact.

Can I use issue tracking with dependency graphs for collaborative project work?

Yes. Beads provides graph-based dependency tracking and audit trails for collaborative work, enabling teams to visualize task relationships, blockers, and knowledge dependencies while maintaining persistent memory across sessions.

What's the best way to maintain project memory during conversation compaction?

Beads uses git-backed persistence and issue-tracker storage to preserve project state through compaction cycles. Your task graphs, decisions, and context survive automatically, eliminating manual re-entry of work history.

How does Beads integrate with automated orchestration workflows?

Beads works with Conductor for automated orchestration, combining file-based and review components to handle complex workflows. It manages dependencies and provides durable context for multi-step processes requiring knowledge-work coordination.

Can I use Beads for work spanning weeks with multiple blockers and dependencies?

Beads is designed for exactly this scope. It tracks multi-week work with blockers, dependencies, and knowledge components, maintaining full audit trails and dependency visibility so complex projects stay coherent across extended timelines.

Do I need external tools to manage persistent memory in collaborative environments?

Beads provides built-in persistent memory without requiring separate systems. Its git-backed storage and dependency graphs handle project memory internally, supporting collaborative work across sessions with automatic context preservation.