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
Charles P. Cross a82f393e49
fix(storage): implement RenameDependencyPrefix to preserve dependencies (#642)
* fix(storage): implement RenameDependencyPrefix to update dependency records

RenameDependencyPrefix was previously a no-op that returned nil without
updating any records. This caused dependencies to break after using
bd rename-prefix, as the issue_id and depends_on_id columns in the
dependencies table still referenced the old prefix.

The fix updates both columns in the dependencies table to use the new
prefix, ensuring all dependency relationships are preserved.

Fixes #630

* test(storage): add regression tests for RenameDependencyPrefix

Add tests verifying that RenameDependencyPrefix:
- Executes without error when no dependencies exist
- Can be called with various prefix combinations

These tests ensure the fix for GH#630 doesn't regress.

---------

Co-authored-by: Charles P. Cross <cpdata@users.noreply.github.com>
2025-12-19 17:52:44 -08:00
.agent/workflows fix: improve JSONL-only mode detection and error messages (GH #534) 2025-12-13 12:50:33 -08:00
.beads Setup emma as crew worker 2025-12-19 12:48:52 -08:00
.beads-hooks Merge GH#532 2025-12-16 01:19:14 -08:00
.claude feat: Add test infrastructure with automatic skip list 2025-11-21 22:43:04 -05:00
.claude-plugin chore: Bump version to 0.30.6 2025-12-18 22:46:14 -08:00
.devcontainer Fix devcontainer init check - look for DB file not directory 2025-11-05 17:31:30 -08:00
.github fix: Update npm publish to use OIDC trusted publishing 2025-12-17 19:51:10 -08:00
cmd/bd fix(sync): respect sync.branch config when no upstream tracking (#640) 2025-12-19 17:52:27 -08:00
commands fix(docs): use consistent in_progress status naming (GH#444) 2025-12-16 01:07:33 -08:00
docs Update CLI reference with new --body-file options (#627) 2025-12-18 18:25:09 -08:00
examples refactor: Remove legacy MCP Agent Mail integration (bd-6gd) 2025-12-17 23:14:23 -08:00
integrations/beads-mcp chore: Bump version to 0.30.6 2025-12-18 22:46:14 -08:00
internal fix(storage): implement RenameDependencyPrefix to preserve dependencies (#642) 2025-12-19 17:52:44 -08:00
npm-package chore: Bump version to 0.30.6 2025-12-18 22:46:14 -08:00
scripts fix: sync all version files to 0.30.2 and add CI check 2025-12-16 17:13:01 -08:00
skills/beads refactor: Remove legacy MCP Agent Mail integration (bd-6gd) 2025-12-17 23:14:23 -08:00
tests/integration refactor: Remove legacy MCP Agent Mail integration (bd-6gd) 2025-12-17 23:14:23 -08:00
.gitattributes bd-6xd: Standardize on issues.jsonl as canonical filename 2025-11-26 22:02:59 -08:00
.gitignore chore: gitignore Gas Town state.json 2025-12-18 20:23:23 -08:00
.golangci.yml fix(lint): add batch_ops.go to G201 exclusion 2025-12-18 21:28:20 -08:00
.goreleaser.yml fix: Add commit and branch to bd version output (github #503) 2025-12-13 10:04:01 +11:00
.test-skip Remove TestFallbackToDirectModeEnablesFlush from test skip list 2025-11-23 16:05:28 -08:00
AGENT_INSTRUCTIONS.md fix: improve JSONL-only mode detection and error messages (GH #534) 2025-12-13 12:50:33 -08:00
AGENTS.md refactor: Remove legacy MCP Agent Mail integration (bd-6gd) 2025-12-17 23:14:23 -08:00
beads.go Export Transaction type for atomic multi-operation support 2025-11-24 22:55:55 -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 fix(merge): proper 3-way merge for dependencies - removals win (bd-ndye) 2025-12-18 23:20:49 -08:00
CLAUDE.md Setup dave as crew worker 2025-12-19 12:50:43 -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 fix: update nix vendorHash for Go dependencies 2025-12-18 00:45:38 -05: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 add visual create-form command 2025-12-16 17:05:45 -08:00
go.sum add visual create-form command 2025-12-16 17:05:45 -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 fix: Add commit and branch to bd version output (github #503) 2025-12-13 10:04:01 +11:00
README.md docs: restore Community Tools section with beads.el 2025-12-17 13:45:41 -08:00
RELEASING.md Add --upgrade-mcp flag to bump-version.sh 2025-11-23 22:25:37 -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.
bd quickstart Interactive guide for AI agents.

🔗 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

  • beads_viewer - Keyboard-driven terminal UI with kanban board, insights panel, and graph view. Built by @Dicklesworthstone.
  • beads.el - Emacs UI to browse, edit, and manage beads. Built by @ctietze.
  • beads-ui - Local web interface with live updates and kanban board. npx beads-ui start. Built by @mantoni.
  • bdui - Real-time terminal UI with tree view, dependency graph, and vim-style navigation. Built by @assimelha.
  • perles - Terminal UI with BQL (Beads Query Language) and multi-view kanban. Built by @zjrosen.
  • vscode-beads - VS Code extension with issues panel and daemon management. Built by @jdillon.

📝 Documentation