When should I use Beads instead of TodoWrite?

Use Beads for multi-session work, complex dependencies, or strategic research. Use TodoWrite for simple, linear tasks that you expect to finish within a single session.

How does Beads differ from a standard TODO list?

Beads is a graph-based system that tracks complex dependencies and persists data across multiple Claude sessions, ensuring context isn't lost during session compaction.

What is 'compaction' and why does Beads help?

Compaction is when an LLM's conversation history is summarized to save space. Beads stores data in a persistent database, allowing the AI to retain 'long-term memory' of tasks after this summary occurs.

Does this skill work across different coding projects?

Yes, it supports project-local databases in a .beads/ directory and a global fallback at ~/.beads/ for cross-project task management.

Can I export my issue data for other tools?

Yes, the Beads CLI supports a --json flag for all core operations, allowing for structured data export and integration with other programmatic workflows.

Beads Issue Tracker for Claude

Name: Beads Issue Tracker for Claude
Author: johnnymo87

byjohnnymo87

0•

生产力与工作流

Manages complex multi-session development tasks using graph-based issue tracking and persistent dependency memory.

The Beads (bd) issue tracker skill provides a robust framework for managing non-linear development tasks that span multiple sessions. By utilizing a graph-based structure, it allows Claude to maintain persistent context and 'long-term memory' even after session compaction events. This skill is essential for developers handling complex projects with intricate dependencies, strategic research, or exploratory side quests where simple checklists fall short.

主要功能

01Persistent task memory designed to survive LLM session compaction cycles

02Proactive session-start protocols to automatically resume work with full context

030 GitHub stars

04Automatic database discovery for both project-local and global task management

05Comprehensive issue lifecycle management with priority levels and status tracking

06Graph-based dependency tracking including blockers, parent-child, and related links

使用场景

01Tracking exploratory research and side quests without losing progress on main objectives

02Managing large-scale refactoring projects with complex interdependent subtasks

03Maintaining project continuity across multiple days or weeks of asynchronous work

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add johnnymo87/dotfiles using-beads-for-issue-tracking

For use in Claude.ai and ChatGPT

Download Skill