# gastownhall/beads

Beads - A memory upgrade for your coding agent

Repository: https://github.com/gastownhall/beads
Canonical: https://ross.abutalabs.com/products/beads
Homepage: https://beads.gascity.com
Language: Go
License: MIT
License Family: permissive
Topics: agents, claude-code, coding
Last push: 2026-08-25T23:38:41+00:00

## Health v2 (maintenance only)
Score: 79/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 86, longevity 23
- inputs: {"age_days": 325, "days_push": 8, "days_rel": 18, "gap_med": 1.0, "n_releases_24m": 93}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 26626, forks 1801 (observed 2026-08-28T04:11:47.031369+00:00)

## What it is
Beads (bd) is a dependency-aware, Dolt-backed distributed issue tracker designed for AI coding agents, providing persistent structured memory that survives context loss. It replaces markdown plans with a dependency graph, computes a ready queue of unblocked work, and syncs across machines via Dolt push/pull over git remotes or object-storage buckets.

## Use cases
- give my coding agent persistent memory across sessions
- track tasks with dependencies for AI agents
- coordinate multiple AI agents working on the same repo
- replace markdown plan files with a structured task graph
- sync issue data across machines without running a server
- show only unblocked work to an agent
- integrate issue tracking with Claude Code or Cursor

## When to choose
- you run AI coding agents (Claude Code, Codex, Cursor, etc.) on long-horizon tasks and lose context between sessions
- you need dependency-aware task queues so agents pick unblocked work
- you want multi-agent coordination with hash-based collision-free IDs
- you want serverless sync via git remotes, DoltHub, or S3/GCS buckets

## When to avoid
- you need a traditional human-team issue tracker with boards and dashboards (use Jira or GitHub Issues)
- your project cannot add a .beads/ directory or git hooks
- you don't want to install and pin a specific Dolt version
- you need a hosted service with a web UI rather than a CLI

## Facets
- artifact type: cli-tool
- maturity: active
- function: developer-tools, workflow-automation, agent-framework, mcp, database, cli
- domain: developer-tools, large-language-models
- platform: windows, bsd, cli, go, python
- tags: issue-tracker, coding-agents, dolt, dependency-graph, persistent-memory, multi-agent-coordination, claude-code, mcp-server, ai-agents, automation, command-line, macos, linux, nodejs

## Member repositories
- gastownhall/beads (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:47.031369+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:55:50.831075+00:00, confidence not recorded.
  - readme: https://github.com/gastownhall/beads (fetched 2026-08-28T04:11:47.031369+00:00, sha b3b7953f2bb7)
  - homepage: https://beads.gascity.com (fetched 2026-08-29T07:52:11.790792+00:00, sha c343a2c0044a)
  - site_page: https://beads.gascity.com/getting-started/installation (fetched 2026-08-29T07:52:11.793548+00:00, sha d78d66277255)
  - site_page: https://beads.gascity.com/getting-started/quickstart (fetched 2026-08-29T07:52:11.796387+00:00, sha 9defb5487533)
  - site_page: https://beads.gascity.com/getting-started/ide-setup (fetched 2026-08-29T07:52:11.798324+00:00, sha 48fe78ee13e2)
  - site_page: https://beads.gascity.com/getting-started/sync-setup (fetched 2026-08-29T07:52:11.800444+00:00, sha 690eeab44abc)
  - site_page: https://beads.gascity.com/getting-started/upgrading (fetched 2026-08-29T07:52:11.802839+00:00, sha 67303a48c8e6)
  - site_page: https://beads.gascity.com/recovery/uninstalling (fetched 2026-08-29T07:52:11.806026+00:00, sha 360a059f824d)
  - site_page: https://beads.gascity.com/multi-agent/bucket-federation (fetched 2026-08-29T07:52:11.808683+00:00, sha 22cb93fb6978)
  - site_page: https://beads.gascity.com/integrations (fetched 2026-08-29T07:52:11.811268+00:00, sha 53a1313e20ba)
- Data as of 2026-08-30T08:39:29.467469+00:00.