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

•

Productividad y Flujo de Trabajo

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

Acerca de

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.

Características Principales

AI-optimized context loading via the 'bd prime' workflow hook.
Graph-based dependency tracking to manage complex, non-linear development tasks.
Reusable task templates (Molecules) for standardized component development.
1 GitHub stars
Async gates for streamlined human-in-the-loop feedback and approvals.
Git-backed persistence that survives conversation compaction and session resets.

Casos de Uso

Synchronizing task state and progress across a distributed team via Git.
Managing large-scale refactoring projects that span multiple days and sessions.
Tracking research findings and fuzzy task boundaries during exploratory development.

Acerca de

Características Principales

AI-optimized context loading via the 'bd prime' workflow hook.
Graph-based dependency tracking to manage complex, non-linear development tasks.
Reusable task templates (Molecules) for standardized component development.
1 GitHub stars
Async gates for streamlined human-in-the-loop feedback and approvals.
Git-backed persistence that survives conversation compaction and session resets.

Casos de Uso

Synchronizing task state and progress across a distributed team via Git.
Managing large-scale refactoring projects that span multiple days and sessions.
Tracking research findings and fuzzy task boundaries during exploratory development.