skills.rest
phucle297
phucle297COMMUNITY
Explore all skills by this author →
GitHub

beads

Track multi-session issues with dependencies using the beads CLI.

Updated Jan 13, 2025
Search Tags:#dependency management#issue tracking#multi-session#context recovery#work tracking
One-click install
npx skills add https://github.com/phucle297/dotfiles --skill beads-phucle297
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: beads
Source: https://github.com/phucle297/dotfiles/tree/main/.claude/plugins/cache/beads-marketplace/beads/1.0.4/skills/beads
Command: npx skills add https://github.com/phucle297/dotfiles --skill beads-phucle297

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires beads, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a robust system for tracking multi-session work with dependencies and persistent memory across conversation compaction, ideal for complex projects with ongoing work and context recovery needs.

Core Features & Use Cases

  • Multi-Session Work Tracking: Persistent memory for work that spans multiple sessions, conversations, or days.
  • Dependency Management: Graph-based tracking of blockers and prerequisites, with automatic ready detection.
  • Persistent Memory: Survives conversation compaction to maintain context over long periods.
  • Use Case: Ideal for managing projects that require tracking complex dependencies and context, such as software development, project management, or research.

Quick Start

Use the beads skill to create a new issue for a feature you're working on. For example, to create an issue for "Implement user authentication":

beads create "Implement user authentication" -t feature -p 1

Frequently Asked Questions about beads

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

FAQPage Schema
How do I track multi-session work with persistent memory across conversation gaps?▼

Multi-session work tracking with persistent memory is managed by using a graph-based issue system that survives conversation compaction. Issues are created with priorities and types, ensuring context recovery across long gaps between sessions.

What is dependency management for issue tracking and how does it handle blockers?▼

Dependency management for issue tracking uses a graph-based structure to map blockers and prerequisites. It provides automatic ready detection, ensuring tasks are only flagged as actionable once their dependencies are resolved.

How do I create an issue for a feature with priority and type tags?▼

To create an issue for a feature, use the create command with the issue title, type, and priority flags. This structures the task within the tracking system for immediate synchronization and dependency mapping.

Do I need a git repository to use beads for context recovery?▼

A git repository and the beads CLI are required to initialize synchronization for context recovery. The system relies on this environment to maintain persistent memory and manage hierarchical issue structures.

What's the best way to manage complex project workflows with hierarchical dependencies?▼

Managing complex project workflows with hierarchical dependencies is best handled by a structured issue tracking approach. It supports graph-based dependency resolution and tracks ongoing work across multiple sessions.

Why does conversation compaction cause context loss in long-term work tracking?▼

Conversation compaction causes context loss when tracking systems lack persistent memory. This issue is resolved by using a dedicated tracking tool that maintains context and dependency states independently of the conversation history.

Related Skills

Explore More Software Engineering Skills→
SandroBeatzSandroBeatz

beads

Manage project issues and tasks with the beads (bd) command-line tracker.

Community
Intermediate
TMI-appsTMI-apps
2

consolidate

Identifies and classifies duplicated code patterns across a repository to generate a migration plan.

Official
Advanced
alangebalangeb

git-advanced

Perform Git bisecting, cherry-picking, and log analysis operations locally.

Community
Advanced
tjmgregorytjmgregory

using-beads

Manage persistent task and issue tracking via the bd command-line interface.

Community
Advanced