When should I use Beads instead of TodoWrite?

Use Beads for multi-session work, tasks with complex dependencies, or when context must survive conversation compaction. Use TodoWrite for simple, linear tasks completed in a single session.

What happens to my Beads data during context compaction?

Beads data is stored in a local SQLite database, meaning it remains fully preserved and accessible even when Claude's conversation history is cleared or reset.

Can I use Beads across different projects?

Yes, Beads supports project-local databases within a .beads/ directory and a global fallback in ~/.beads/ for cross-project tracking.

How does Beads handle task dependencies?

Beads uses a graph structure allowing you to define blockers and prerequisites, ensuring the agent understands the logical order of execution for complex features.

How does the agent know when to checkpoint progress?

The skill includes protocols to monitor token usage; once usage exceeds 70-85%, the agent is instructed to proactively update Beads notes to ensure context survival.

Beads Persistent Issue Tracker

Name: Beads Persistent Issue Tracker
Author: thanhtoan105

bythanhtoan105

•

Productividad y Flujo de Trabajo

Tracks complex, multi-session development tasks with dependency graphs to maintain persistent context across LLM compaction cycles.

Beads is a specialized graph-based issue tracker designed to provide Claude with persistent memory during long-running development projects. Unlike temporary checklists, Beads maintains a structured database of tasks, dependencies, and architectural decisions that survive conversation compaction events. It is essential for managing work that spans multiple days, involves complex blockers, or requires deep strategic context that would otherwise be lost when the conversation history is cleared. By using a local database, it ensures that 'future' versions of the agent can pick up exactly where the previous session left off with zero loss of critical technical decisions.

Características Principales

01Standardized COMPLETED/IN PROGRESS/NEXT note patterns for seamless handoffs

02Graph-based dependency tracking to manage blockers and task hierarchies

03Persistent memory storage that survives conversation history compaction

041 GitHub stars

05Automatic database discovery for project-local or global task management

06Proactive token-usage monitoring for timely progress checkpointing

Casos de Uso

01Tracking exploratory research and side quests without losing primary task context

02Managing multi-day architectural migrations or large-scale refactoring projects

03Resuming complex development work after long breaks with full state recovery

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thanhtoan105/accounting_erp_chatbot beads

For use in Claude.ai and ChatGPT

Download Skill