Do I need to initialize Beads manually?

Yes, a human must run 'bd init' once in the repository to set up the .beads/ directory before the AI agent can begin tracking tasks.

When should I use Beads instead of TodoWrite?

Use Beads for work that spans multiple sessions, has complex blockers, or requires long-term context; use TodoWrite for simple, linear tasks that will be finished in the current session.

What happens to my tasks when the AI conversation is compacted?

Tasks remain safely stored in the local .beads/ directory, allowing the AI to re-read the full state and history in the next session without losing progress.

Can Beads handle multi-developer collaboration?

Yes, because it is git-backed, you can use 'bd sync' to push and pull task states, allowing multiple people and AI agents to work from the same issue graph.

How does Beads differ from standard markdown task lists?

Unlike markdown lists, Beads tracks complex dependencies and stores data in a structured git-backed database that survives when the AI's conversation memory is cleared or compacted.

Beads - Persistent Task Memory

Name: Beads - Persistent Task Memory
Author: edmundmiller

byedmundmiller

•

Productividad y Flujo de Trabajo

Manages complex, multi-session tasks and dependencies with a git-backed graph-based issue tracker that survives conversation compaction.

Acerca de

Beads (bd) provides a robust, persistent memory system for Claude, allowing it to track intricate work across multiple sessions and compaction cycles. Unlike transient task lists, Beads uses a dependency-aware graph stored directly in your git repository, ensuring that context, blockers, and progress notes remain accessible even after long breaks or history resets. It is the ideal tool for exploratory research, multi-stage feature development, and any project where maintaining a clear audit trail of decisions and dependencies is critical for AI-human continuity.

Características Principales

Smart task discovery prioritizing ready work and identifying project bottlenecks
Automatic synchronization with remote repositories for collaborative AI-human workflows
Git-integrated persistence that survives AI conversation history compaction
Graph-based dependency tracking to manage blockers and parent-child task relationships
Detailed audit trails including status changes, notes, and decision history
42 GitHub stars

Casos de Uso

Maintaining a shared task state between human developers and AI agents within a single repository
Tracking exploratory research where new sub-tasks are discovered incrementally
Managing large-scale software refactors that span several days and multiple chat sessions

Acerca de

Características Principales

Smart task discovery prioritizing ready work and identifying project bottlenecks
Automatic synchronization with remote repositories for collaborative AI-human workflows
Git-integrated persistence that survives AI conversation history compaction
Graph-based dependency tracking to manage blockers and parent-child task relationships
Detailed audit trails including status changes, notes, and decision history
42 GitHub stars

Casos de Uso

Maintaining a shared task state between human developers and AI agents within a single repository
Tracking exploratory research where new sub-tasks are discovered incrementally
Managing large-scale software refactors that span several days and multiple chat sessions