Beads

Features

• Dolt-powered version-controlled SQL database
• Agent-optimized JSON output and task detection
• Dependency tracking and graph links
• Messaging with threading and delegation
• Supports multiple storage modes (embedded, server)

Use Cases

• Managing complex, long-horizon tasks for AI coding agents.
• Providing a persistent, structured memory for agent workflows.
• Tracking task dependencies and relationships in a graph structure.
• Facilitating collaboration between multiple agents on shared projects.

Non-Goals

• Replacing general-purpose task managers or bug trackers for human use.
• Providing a generic LLM interface; specific agent integration is key.
• Acting as a direct replacement for version control systems like Git for code management.

Workflow

1. Install Beads CLI system-wide.
2. Initialize Beads in your project directory (`bd init`).
3. Configure agent integration (`bd setup <agent_name>`).
4. Use core commands (`bd create`, `bd ready`, `bd update`, `bd show`) to manage tasks.
5. Leverage `bd prime` for workflow context and `bd remember` for persistent memory.

Practices

• Agent workflow integration
• Task dependency management
• Persistent memory storage

Prerequisites

• macOS, Linux, Windows, or FreeBSD
• Shell environment (bash, zsh, etc.)