Beads - A memory upgrade for your coding agent https://beads.gascity.com
  • Go 95.2%
  • Python 1.6%
  • Starlark 1.5%
  • Shell 1.3%
  • Rust 0.2%
Find a file
emma f91bbf3a03 fix(build): add CGO build constraints for Dolt-dependent files
The dolthub/gozstd dependency requires CGO. Several files were importing
the dolt package without build constraints, causing CI failures when
building with CGO_ENABLED=0 for Linux, FreeBSD, and Android.

Changes:
- Add //go:build cgo to federation.go and doctor/federation.go
- Create dolt_server_cgo.go/nocgo.go to abstract dolt.Server usage
- Create federation_nocgo.go with stub command explaining CGO requirement
- Create doctor/federation_nocgo.go with stub health checks
- Update daemon.go to use the dolt server abstraction

Federation and Dolt-specific features are unavailable in non-CGO builds.
Users are directed to pre-built binaries from GitHub releases.

Fixes v0.49.0 CI failure.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-22 00:01:37 -08:00
.agent/workflows fix: improve JSONL-only mode detection and error messages (GH #534) 2025-12-13 12:50:33 -08:00
.beads chore: revert accidental .beads/ changes from #1231 2026-01-21 21:51:07 -08:00
.beads-hooks Fix shebang env (#817) 2026-01-01 10:54:22 -08:00
.claude docs: update daemon CLI syntax from flags to subcommands 2026-01-14 21:47:15 -08:00
.claude-plugin chore: Bump version to 0.49.0 2026-01-21 23:42:07 -08:00
.devcontainer Fix devcontainer init check - look for DB file not directory 2025-11-05 17:31:30 -08:00
.github chore(deps): bump actions/upload-pages-artifact from 3 to 4 (#1055) 2026-01-12 23:05:05 -08:00
claude-plugin chore: Bump version to 0.49.0 2026-01-21 23:42:07 -08:00
cmd/bd fix(build): add CGO build constraints for Dolt-dependent files 2026-01-22 00:01:37 -08:00
docs fix(daemon): prevent zombie state after database file replacement (#1213) 2026-01-21 22:46:59 -08:00
examples docs: update daemon CLI syntax from flags to subcommands 2026-01-14 21:47:15 -08:00
integrations chore: Bump version to 0.49.0 2026-01-21 23:42:07 -08:00
internal fix(daemon): prevent zombie state after database file replacement (#1213) 2026-01-21 22:46:59 -08:00
npm-package chore: Bump version to 0.49.0 2026-01-21 23:42:07 -08:00
scripts chore: move WSL2 test scripts to scripts directory 2026-01-21 16:54:24 -08:00
tests/integration refactor: Remove legacy MCP Agent Mail integration (bd-6gd) 2025-12-17 23:14:23 -08:00
website Merge origin/main into db/fix-2 (resolve conflicts) 2026-01-20 19:49:12 -08:00
winget Add Windows ARM64 build support (#834) 2026-01-01 19:46:02 -08:00
.gitattributes fix(autoimport): auto-correct deleted status to tombstone for JSONL compatibility (#1231) 2026-01-21 21:50:38 -08:00
.gitignore Add .direnv folder to .gitignore (#1248) 2026-01-21 19:30:07 -08:00
.golangci.yml fix(lint): resolve CI lint failures for v0.47.0 release 2026-01-08 20:21:02 -08:00
.goreleaser.yml feat: comprehensive NixOS support improvements (#1024) 2026-01-12 23:46:33 -08:00
.pre-commit-config.yaml refactor: remove unused bd pin/unpin/hook commands (bd-x0zl) 2025-12-27 16:02:15 -08:00
.test-skip chore: code health review - test fix and error comments (bd-9g1z, bd-ork0) 2025-12-22 21:30:57 -08:00
AGENT_INSTRUCTIONS.md docs: Add agent warning about interactive bd edit command 2026-01-13 20:58:07 -08:00
AGENTS.md Merge pull request #1138 from steveyegge/fix/agents-md-claude-md-reference-1049 2026-01-17 00:24:55 -08:00
beads.go feat: show redirect info in bd prime output (bd-kblo) 2025-12-27 21:33:01 -08:00
beads_test.go bd-6xd: Standardize on issues.jsonl as canonical filename 2025-11-26 22:02:59 -08:00
BENCHMARKS.md feat(cli): add 'bd thanks' command to thank contributors 2025-12-14 12:40:32 -08:00
build-docs.md docs: Add comprehensive documentation for version reporting changes 2025-12-13 10:04:01 +11:00
CHANGELOG.md chore: Bump version to 0.49.0 2026-01-21 23:42:07 -08:00
CONTRIBUTING.md feat(daemon): unify auto-sync config for simpler agent workflows (#904) 2026-01-06 12:52:19 -08:00
default.nix chore: Bump version to 0.49.0 2026-01-21 23:42:07 -08:00
FEDERATION-SETUP.md docs: add federation setup guide (bd-wkumz.7) 2026-01-20 23:13:31 -08:00
flake.lock feat: Add Nix flake for declarative builds 2025-10-15 13:45:05 +02:00
flake.nix fix(nix): bake shell completions into default package (#1229) 2026-01-21 19:11:21 -08:00
go.mod fix: enable building on Windows without CGO (#1117) 2026-01-15 19:23:02 -08:00
go.sum fix: enable building on Windows without CGO (#1117) 2026-01-15 19:23:02 -08:00
install.ps1 docs: don't auto-install Go in Windows installer; instruct user instead (fixes #292) (#302) 2025-11-12 14:15:46 -08:00
LICENSE Initial commit: Beads issue tracker with security fixes 2025-10-11 20:07:36 -07:00
Makefile refactor: remove unused bd pin/unpin/hook commands (bd-x0zl) 2025-12-27 16:02:15 -08:00
README.md fix(routing): auto-enable hydration and flush JSONL after routed create (#1251) 2026-01-21 21:22:04 -08:00
RELEASING.md docs: update paths for claude-plugin subdirectory structure (GH#985) (#1007) 2026-01-10 22:49:29 -08:00
SECURITY.md Prepare for public launch: comprehensive examples, docs, and tooling 2025-10-12 11:25:29 -07:00
THIRD_PARTY_LICENSES Add THIRD_PARTY_LICENSES for Apache 2.0 Dolt dependencies 2026-01-16 12:19:57 -08:00

bd - Beads

Distributed, git-backed graph issue tracker for AI agents.

License Go Report Card Release npm version PyPI

Beads provides a persistent, structured memory for coding agents. It replaces messy markdown plans with a dependency-aware graph, allowing agents to handle long-horizon tasks without losing context.

⚡ Quick Start

# Install (macOS/Linux/FreeBSD)
curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash

# Initialize (Humans run this once)
bd init

# Tell your agent
echo "Use 'bd' for task tracking" >> AGENTS.md

🛠 Features

  • Git as Database: Issues stored as JSONL in .beads/. Versioned, branched, and merged like code.
  • Agent-Optimized: JSON output, dependency tracking, and auto-ready task detection.
  • Zero Conflict: Hash-based IDs (bd-a1b2) prevent merge collisions in multi-agent/multi-branch workflows.
  • Invisible Infrastructure: SQLite local cache for speed; background daemon for auto-sync.
  • Compaction: Semantic "memory decay" summarizes old closed tasks to save context window.

📖 Essential Commands

Command Action
bd ready List tasks with no open blockers.
bd create "Title" -p 0 Create a P0 task.
bd dep add <child> <parent> Link tasks (blocks, related, parent-child).
bd show <id> View task details and audit trail.

🔗 Hierarchy & Workflow

Beads supports hierarchical IDs for epics:

  • bd-a3f8 (Epic)
  • bd-a3f8.1 (Task)
  • bd-a3f8.1.1 (Sub-task)

Stealth Mode: Run bd init --stealth to use Beads locally without committing files to the main repo. Perfect for personal use on shared projects.

Contributor vs Maintainer: When working on open-source projects:

  • Contributors (forked repos): Run bd init --contributor to route planning issues to a separate repo (e.g., ~/.beads-planning). Keeps experimental work out of PRs.
  • Maintainers (write access): Beads auto-detects maintainer role via SSH URLs or HTTPS with credentials. Only need git config beads.role maintainer if using GitHub HTTPS without credentials but you have write access.

📦 Installation

  • npm: npm install -g @beads/bd
  • Homebrew: brew install steveyegge/beads/bd
  • Go: go install github.com/steveyegge/beads/cmd/bd@latest

Requirements: Linux, FreeBSD, macOS, or Windows.

🌐 Community Tools

See docs/COMMUNITY_TOOLS.md for a curated list of community-built UIs, extensions, and integrations—including terminal interfaces, web UIs, editor extensions, and native apps.

📝 Documentation