Beads Files

beads v0.60.0

Pre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android/Termux (ARM64), and FreeBSD.

Installation

Homebrew (macOS/Linux):

:::bash
brew install beads

Quick Install (macOS/Linux/FreeBSD):

:::bash
curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash

Windows (PowerShell):

:::powershell
irm https://raw.githubusercontent.com/steveyegge/beads/main/install.ps1 | iex

Manual Install: Download the appropriate binary for your platform below, extract it, and place it in your PATH.

Changelog

Features

• [43bca2] feat: JSON-aware error output + JSONL schema validation + contract tests (GH#2499)
• [71d7ae] feat: add --design-file flag for reading design from files
• [12dc4e] feat: add --destroy-token for safe non-interactive re-init (GH#2497)
• [9dc875] feat: add --list and --doc flags to bd help for CLI doc generation (GH#2527)
• [0cf866] feat: add GitHub Issues integration (tracker plugin) (GH#2373)
• [ac9ac7] feat: add bd context command and safe-first error guidance (fix-merge PR [#2496])
• [0bb3bf] feat: add workspace identity preflight and bd bootstrap command (GH#2438, GH#2372)
• [efd756] feat: bd bootstrap executes recovery actions instead of printing advice
• [2df714] feat: bd done <id> <message> treats last arg as reason
• [21e23b] feat: epic close guards, merge re-parenting, and progress display
• [b7cc48] feat: replace hash-derived dolt ports with OS-assigned ephemeral ports (GH#2415)
• [5e1d4b] feat: search external_ref in bd search (GH#2494)
• [3a2d35] feat: support global ~/.config/beads/PRIME.md fallback (GH#2330)

Bug Fixes

• [0c12f4] Merge PR [#2390]: fix(deps): update github.com/dolthub/driver digest to bbe1450
• [dbbe21] Merge PR [#2408]: fix(worktree): skip .gitignore append when parent directory pattern covers
• [c3e705] Merge PR [#2413]: fix(deps): update opentelemetry-go monorepo to v1.42.0
• [93841b] Merge PR [#2417]: fix: bd mol wisp reports wrong count when RootOnly=true
• [3502cb] Merge PR [#2432]: fix: use Root().PersistentFlags() to check --json in PersistentPreRun
• [1d2550] Merge PR [#2440]: fix: replace stale 'bd sync' references in CLI help, setup generators, and docs
• [1ffbd0] Merge PR [#2443]: fix(list): --json flag ignored when --tree defaults to true
• [f1e607] Merge PR [#2529]: fix(deps): update github.com/dolthub/driver digest to 669bd7f
• [813075] fix(deps): migrate glamour to v2 (charm.land/glamour/v2)
• [4c43d9] fix(deps): update github.com/dolthub/driver digest to 669bd7f
• [dc0b18] fix(deps): update github.com/dolthub/driver digest to bbe1450
• [555abd] fix(deps): update github.com/dolthub/driver digest to ecee5fd
• [7f0397] fix(deps): update module golang.org/x/sync to v0.20.0
• [1a328c] fix(deps): update module golang.org/x/sys to v0.42.0
• [db967a] fix(deps): update module golang.org/x/term to v0.41.0
• [8962de] fix(deps): update opentelemetry-go monorepo to v1.42.0
• [257c05] fix(deps): update testcontainers-go monorepo to v0.41.0
• [a333dc] fix(docs): purge stale bd sync/import/--branch refs + add CI doc validation (GH#2522)
• [f7061f] fix(docs): remove stale --branch flag and SQLite refs from QUICKSTART (GH#2522) (#2525)
• [1fb6b9] fix(dolt): auto-commit pending changes before pull to prevent merge errors (GH#2474)
• [c195a5] fix(list): --json flag ignored when --tree defaults to true
• [15a9d1] fix(list): --json flag ignored when --tree defaults to true
• [44118a] fix(list): --json flag ignored when --tree defaults to true (bd-03r)
• [45fcd5] fix(nix): use go mod edit instead of sed for version patching
• [656a3e] fix(worktree): skip gitignore append when parent dir pattern already covers entry
• [f88c29] fix: Dolt test suite stability — eliminate container crashes and cascading failures (hq-33riy)
• [c9998f] fix: TestDoltStoreDependencies uses same-type issues for blocks dep (GH#1495)
• [cf9f78] fix: TestProtocol_FieldsRoundTrip timezone-aware date assertions
• [838638] fix: YAML config prefix takes precedence over DB in shared-server mode (GH#2469)
• [7d06e6] fix: add BEADS_DOLT_PORT fallback in GetDoltServerPort() (GH#2486)
• [396c94] fix: add shared Dolt server mode for multi-repo/agent setups (GH#2416)
• [69573b] fix: add test coverage for quoted label values with colons (bd-wnr1)
• [1d7bf3] fix: add timeout and graceful DB-missing handling to git hook shims
• [d00c31] fix: auto-clear stale pinned flag on status transition
• [0ba22a] fix: auto-resolve metadata merge conflicts on bd dolt pull (GH#2466)
• [401da9] fix: backfill project_id into pre-GH#2372 Dolt stores via bd doctor --fix (GH#2490)
• [9b04d6] fix: bd children includes closed children by default (GH#2481)
• [12cfd5] fix: bd doctor --fix regenerates missing metadata.json (GH#2482)
• [766fe2] fix: bd doctor detects stale .legacy hook sidecars calling removed bd hook (GH#2398)
• [61ddbe] fix: bd dolt remote add/list/remove operate on wrong directory (GH#2306, GH#2311)
• [d1549d] fix: bd export crash on zero-time timestamps + stale bd sync refs (GH#2488, GH#2493)
• [3dbf3c] fix: bd lint accepts non-empty acceptance_criteria field without heading (GH#2468)
• [c12cce] fix: bd mol wisp reports wrong count when RootOnly=true
• [a84f7c] fix: block bd doctor --fix at Gas Town town root (GH#2450)
• [2c24ce] fix: block data-dir in server mode + fix doctor --clean --json (GH#2438)
• [a5a751] fix: clean formatting drift
• [36a3ec] fix: create .beads/ dir in server mode with external BEADS_DOLT_* env vars (GH#2519)
• [fbbaa5] fix: detect WSL and MINGW/MSYS/CYGWIN in install.sh
• [eae64c] fix: detect backup files on database-not-found and after bd init (GH#2327)
• [4537e0] fix: exclude reparented children from molecule auto-close (GH#2480)
• [e6019d] fix: hide --allow-stale no-op flag from help output
• [e56fc5] fix: idle-monitor preserves port across restart cycles (bd-xvg)
• [9604d3] fix: init guard allows fresh clones with committed metadata.json (GH#2433, GH#2441)
• [9d65ac] fix: merge --metadata with existing metadata instead of replacing (GH#2423)
• [141119] fix: move KillStaleServers inside flock to prevent journal corruption (GH#2430)
• [459160] fix: move auto-push state to local file, preventing metadata merge conflicts (GH#2466)
• [5227ea] fix: preserve dependency metadata in JSONL backups (GH#2487)
• [a7755e] fix: prevent bd init from creating DB on another project's Dolt server (GH#2336)
• [4df17c] fix: remove idle monitor and activity signal daemon infrastructure (GH#2452)
• [100962] fix: remove stale 'sync' from noDbCommands breaking sync subcommands (GH#2419)
• [3e20e7] fix: replace dangerous --force suggestion in init guard error message
• [31bae5] fix: replace hash-derived dolt ports with OS-assigned ephemeral ports (GH#2415)
• [b7bd6d] fix: replace stale 'bd sync' references with bd dolt push/commit (GH#2435)
• [cd2f50] fix: replace stale bd migrate --to-dolt with bd init --from-jsonl (GH#2333)
• [bdbbb4] fix: restore --allow-stale as no-op flag for gt compatibility
• [de483f] fix: restore denormalized JSONL from bd export without data loss (GH#2479)
• [b51566] fix: skip sleep in CI/non-interactive environments
• [5a454a] fix: suppress pre-existing gosec false positives with nolint directives
• [2d3ce0] fix: sync CLI remotes into SQL server on store open (GH#2315)
• [56cd58] fix: typo in --design-file error message ("stin" -> "stdin")
• [491242] fix: update cliDir() → CLIDir() after linter rename
• [491c27] fix: use CLIDir for dolt remote operations instead of root Path (GH#2306, GH#2311)
• [0c96d8] fix: use Root().PersistentFlags() for all persistent flag checks in PersistentPreRun (GH#2514)
• [fc8ea1] fix: use Root().PersistentFlags() to check --json flag in PersistentPreRun
• [c4b897] fix: use absolute path for core.hooksPath so worktree hooks work (GH#2414)
• [67d678] fix: use explicit DOLT_ADD to prevent config corruption from stale working set (GH#2455)
• [f0078a] fix: warn on Dolt endpoint drift during auto-start (GH#2399)
• [6615c7] fix: wrap DOLT_PULL in explicit transaction for autocommit compat (GH#2501)

Others

• [59fe98] /cmd/bd: use interface instead of struct
• [ef8c46] /internal/storage/embeddeddolt/schema.go: wip, need test
• [48cb33] /internal/storage/embeddeddolt/store.go: change witConn a bit
• [eeb97a] /internal/storage/embeddeddolt: add schema test
• [185eac] /internal/storage/embeddeddolt: cleanup
• [8b24dc] /internal/storage/embeddeddolt: remove dolt commit stuff in migrations
• [44a386] /internal/storage/embeddeddolt: wip, schema migrations
• [d5b754] /internal/storage/storage.go: fix store name
• [6500ea] /internal/storage: add interfaces for methods not covered by Storage
• [57b1f0] Add 'bd done' as alias for 'bd close'
• [725002] Fix config package shadow in compact command
• [14df21] Fix repo-local Dolt ports across doctor paths (#2403)
• [1ea190] Follow redirect target when cleaning stale lock files
• [7ba3a0] Merge PR [#2401]: Follow redirect target when cleaning stale lock files
• [e823b5] Merge PR [#2437]: Fix config package shadow in compact command
• [96a2f6] Prefer stable branch worktrees for BEADS_DIR
• [9d5eae] Stabilize BEADS_DIR paths from detached commit worktrees
• [33ce6b] Support ai.api_key config as fallback for ANTHROPIC_API_KEY env var
• [61bf8e] Update internal/storage/annotation_queries.go
• [9437d4] Update internal/storage/embeddeddolt/store.go
• [1fd4f6] bd: backup 2026-03-05 22:39
• [2fe052] bd: backup 2026-03-05 22:54
• [7d7f6e] bd: backup 2026-03-05 23:09
• [5ab803] bd: backup 2026-03-05 23:24
• [dff98e] bd: backup 2026-03-05 23:39
• [598cc8] bd: backup 2026-03-05 23:54
• [d799cc] bd: backup 2026-03-06 00:09
• [f18fa4] bd: backup 2026-03-06 00:42
• [68f524] bd: backup 2026-03-06 00:57
• [b2ebf9] bd: backup 2026-03-06 01:12
• [2961ea] chore(deps): bump glamour v0.10.0 to v1.0.0
• [f0bb3a] chore(deps): migrate huh v0.8 to charm.land/huh/v2 (GH#2471)
• [6d6f20] cleanup: add timeout and comment to worktree normalization helpers
• [986334] cleanup: remove 3-way merge engine remnants (GH#2391)
• [84494b] cleanup: remove daemon infrastructure remnants (GH#2431)
• [a5a107] cleanup: remove remaining daemon references missed by GH#2431
• [db5bae] perf: speed up close-time template subgraph loading (GH#2458)
• [ba03db] refactor: remove --allow-stale no-op flag and stale docs (w-bd-002)
• [97e0ee] refactor: remove dead sync mode scaffolding (GH#2485)