Beads

Active
GitHub Go MIT

Description

A memory upgrade for coding agents. Provides persistent contextual memory for Claude Code, Codex, and other coding agents to improve long-task consistency.

Key Features

  • Dolt-powered versioned SQL database — cell-level merge, native branching and remote sync
  • Dependency-aware task graph — replaces Markdown TODOs with graph structure supporting blocks/related/parent-child relationships
  • Agent-optimized output — JSON output format, dependency tracking and auto-ready task detection
  • Hash-based conflict-free IDs — uses bd-a1b2 format IDs to prevent merge conflicts in multi-agent workflows
  • Semantic memory compaction — auto-summarizes old closed tasks to save context window space
  • Hierarchical task structure — supports Epic → Task → Sub-task hierarchy for complex project management

Use Cases

💡 Provide cross-session persistent task memory for Claude Code, Codex and other coding agents
💡 Track task dependencies with graph structures in multi-agent collaborative projects
💡 Use Dolt version control to review task change history and decision records
💡 Accumulate searchable knowledge insights for projects via bd remember
💡 Isolate experimental task branches for open source contributors to avoid polluting main repo

Quick Start

curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash
cd your-project
bd init
bd create "Implement auth" -p 0

Related Projects