How do I ensure my task progress is saved?

Following the session protocol, you should always run 'bd sync' at the end of your work session to persist all changes to your Git repository.

How does Beads differ from the standard TodoWrite tool?

TodoWrite is for simple, single-session checklists. Beads is for complex work involving dependencies, multiple sessions, and team synchronization via Git.

Does Beads require any external software?

Yes, it requires the 'bd' CLI (version 0.34.0 or higher) to be installed in your PATH and an initialized Git repository.

Can I use Beads for team collaboration?

Absolutely. Because Beads is Git-backed, running 'bd sync' allows team members to pull the latest task states, notes, and blockers into their own local environments.

What is conversation compaction and why does Beads help?

Compaction occurs when an AI trims old messages to fit context limits. Beads stores task data in a Git-backed database outside the chat history, ensuring the AI never 'forgets' the project state.

Beads Persistent Task Memory

Name: Beads Persistent Task Memory
Author: dbmcco

bydbmcco

•

생산성 및 워크플로

Manages persistent, graph-based issue tracking that survives AI conversation compaction for multi-session development workflows.

Beads is a Git-backed issue tracker designed to solve the context-loss problem inherent in long-running AI-assisted coding sessions. While standard checklists are ephemeral and vanish when a conversation is compacted or a new session starts, Beads provides a persistent memory layer that tracks complex dependencies and task states across days or weeks. By leveraging a graph-based structure and Git synchronization, it allows Claude to maintain a reliable record of progress, blockers, and research findings, ensuring seamless context recovery for both the AI agent and human collaborators.

주요 기능

01AI-optimized context loading via the 'bd prime' workflow hook.

02Graph-based dependency tracking to manage complex, non-linear development tasks.

03Reusable task templates (Molecules) for standardized component development.

041 GitHub stars

05Async gates for streamlined human-in-the-loop feedback and approvals.

06Git-backed persistence that survives conversation compaction and session resets.

사용 사례

01Synchronizing task state and progress across a distributed team via Git.

02Managing large-scale refactoring projects that span multiple days and sessions.

03Tracking research findings and fuzzy task boundaries during exploratory development.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dbmcco/tmux-beads-loops beads

For use in Claude.ai and ChatGPT

Download Skill