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
Steve Yegge bed89fdfde feat(export): add --priority exact match filter (bd-au0.6)
Add the --priority (-p) flag to bd export for filtering by exact priority,
matching the behavior of bd list. This completes the comprehensive filtering
support for bd export.

The flag uses cmd.Flags().Changed() to properly handle P0 (priority 0), which
would otherwise be interpreted as "not set" due to Go zero-value semantics.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-24 00:06:51 -08:00
.agent/workflows fix: improve JSONL-only mode detection and error messages (GH #534) 2025-12-13 12:50:33 -08:00
.beads bd sync: close bd-g9eu 2025-12-24 00:06:41 -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 v0.35.0 2025-12-23 04:58:19 -08:00
.devcontainer Fix devcontainer init check - look for DB file not directory 2025-11-05 17:31:30 -08:00
.github ci: lower coverage threshold to 42% temporarily 2025-12-19 18:17:07 -08:00
cmd/bd feat(export): add --priority exact match filter (bd-au0.6) 2025-12-24 00:06:51 -08:00
commands feat(audit): add append-only agent audit trail (.beads/interactions.jsonl) 2025-12-20 03:24:51 -08:00
docs bd sync: 2025-12-23 23:38:57 2025-12-24 00:06:41 -08:00
examples fix(docs): correct broken link to LABELS.md in examples 2025-12-20 18:11:16 -08:00
integrations chore: bump version to v0.35.0 2025-12-23 04:58:19 -08:00
internal Fix TestMain to find module root before building bd binary 2025-12-24 00:06:41 -08:00
npm-package chore: bump version to v0.35.0 2025-12-23 04:58:19 -08:00
scripts feat: add --publish-npm and --publish-pypi flags to bump-version.sh 2025-12-23 11:25:35 -08:00
skills/beads bd sync: 2025-12-23 23:38:57 2025-12-24 00:06:41 -08:00
tests/integration refactor: Remove legacy MCP Agent Mail integration (bd-6gd) 2025-12-17 23:14:23 -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 chore: gitignore .runtime/ (Claude Code runtime) 2025-12-23 04:07:16 -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 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 feat: add bd doctor check for orphaned issues (bd-5hrq) 2025-12-21 22:05:14 -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: implement conditional bond type for mol bond (bd-kzda) 2025-12-23 01:32:31 -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 v0.35.0 2025-12-23 04:58:19 -08:00
CLAUDE.md bd sync: 2025-12-23 23:38:57 2025-12-24 00:06:41 -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 chore(nix): update vendorHash for go-sqlite3 0.30.4 and wazero 1.11.0 2025-12-22 14:12:33 -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 chore(deps): bump github.com/ncruces/go-sqlite3 from 0.30.3 to 0.30.4 (#703) 2025-12-22 14:11:42 -08:00
go.sum chore(deps): bump github.com/ncruces/go-sqlite3 from 0.30.3 to 0.30.4 (#703) 2025-12-22 14:11:42 -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(doctor): consolidate maintenance commands + improve daemon startup 2025-12-22 20:21:30 -08:00
README.md Add DeepWiki badge to README (#689) 2025-12-22 01:24:52 -08: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.
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