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
beads/crew/emma 3108000f72 fix: add text reference updates to deleteBatchFallback
Code review found that deleteBatchFallback was missing the text
reference update step (replacing "issue-id" with "[deleted:issue-id]"
in connected issues). This aligns the fallback path with the SQLite
batch delete behavior.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 12:24:17 -08:00
.agent/workflows fix: improve JSONL-only mode detection and error messages (GH #534) 2025-12-13 12:50:33 -08:00
.beads feat: implement bd preflight --check flag with test runner (bd-lfak.2) 2025-12-30 22:22:15 -08:00
.beads-hooks Merge GH#532 2025-12-16 01:19:14 -08:00
.claude Add Claude Code settings for zoey crew worker 2025-12-22 18:01:44 -08:00
.claude-plugin chore: bump version to 0.42.0 2025-12-30 21:21:46 -08:00
.devcontainer Fix devcontainer init check - look for DB file not directory 2025-11-05 17:31:30 -08:00
.github feat: add llms.txt standard support for AI agent discoverability (#784) 2025-12-30 18:27:50 -08:00
cmd/bd fix: add text reference updates to deleteBatchFallback 2025-12-31 12:24:17 -08:00
commands docs: update documentation for CLI consolidation (bd-bxqv) 2025-12-27 16:21:08 -08:00
docs Design contributor namespace isolation for beads pollution prevention 2025-12-30 17:06:36 -08:00
examples fix(jira-import): handle Jira API v3 ADF format and explicit field selection (#825) 2025-12-31 11:37:51 -08:00
integrations chore: bump version to 0.42.0 2025-12-30 21:21:46 -08:00
internal fix: support delete in --no-db mode (GH#822) 2025-12-31 11:45:52 -08:00
npm-package chore: bump version to 0.42.0 2025-12-30 21:21:46 -08:00
scripts feat: add llms.txt standard support for AI agent discoverability (#784) 2025-12-30 18:27:50 -08:00
skills/beads docs: Replace Epic Planning with Ready Front model 2025-12-28 21:35:30 -08:00
tests/integration refactor: Remove legacy MCP Agent Mail integration (bd-6gd) 2025-12-17 23:14:23 -08:00
website feat: add llms.txt standard support for AI agent discoverability (#784) 2025-12-30 18:27:50 -08:00
winget feat(packaging): add Windows winget manifest (fixes #524) 2025-12-20 03:38:31 -08:00
.gitattributes bd-6xd: Standardize on issues.jsonl as canonical filename 2025-11-26 22:02:59 -08:00
.gitignore refactor: remove Gas Town references from codebase 2025-12-30 14:13:32 -08:00
.golangci.yml fix(lint): add batch_ops.go to G201 exclusion 2025-12-18 21:28:20 -08:00
.goreleaser.yml feat: add Windows code signing infrastructure (bd-14v0) 2025-12-24 00:07:16 -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
@AGENTS.md refactor(mol): remove molecule.go (superseded by mol.go) 2025-12-21 00:04:25 -08:00
AGENT_INSTRUCTIONS.md refactor: remove unused bd pin/unpin/hook commands (bd-x0zl) 2025-12-27 16:02:15 -08:00
AGENTS.md feat(mol): add distill command to extract protos from epics 2025-12-21 10:32:23 -08:00
bd_new chore: bump version to 0.33.0 2025-12-21 14:44:16 -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 docs: add v0.42.0 changelog and whats-new entries 2025-12-30 21:21:46 -08:00
CLAUDE.md revert: restore original CLAUDE.md (remove Gas Town content leak) 2025-12-30 11:34:46 -08:00
CONTRIBUTING.md ci: add check to reject PRs with .beads/issues.jsonl changes 2025-12-15 23:43:30 -08:00
default.nix feat: add version sync check to bd preflight --check (bd-lfak.5) 2025-12-31 00:08:40 -08:00
flake.lock feat: Add Nix flake for declarative builds 2025-10-15 13:45:05 +02:00
flake.nix fix: NixOS symlink compatibility for mtime and permission checks (#459) 2025-12-05 13:22:09 -08:00
go.mod refactor: remove unused bd pin/unpin/hook commands (bd-x0zl) 2025-12-27 16:02:15 -08:00
go.sum refactor: remove unused bd pin/unpin/hook commands (bd-x0zl) 2025-12-27 16:02:15 -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 consolidate community tools into dedicated docs page 2025-12-28 08:05:32 -07:00
RELEASING.md feat(scripts): add --all, --mcp-local, --restart-daemons flags to bump-version.sh 2025-12-22 16:02:29 -08:00
SECURITY.md Prepare for public launch: comprehensive examples, docs, and tooling 2025-10-12 11:25:29 -07: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)
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.

📦 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 (glibc 2.32+), 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