beads v0.59.0
Pre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android/Termux (ARM64), and FreeBSD.
Installation
Homebrew (macOS/Linux):
brew install beadsQuick Install (macOS/Linux/FreeBSD):
curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/steveyegge/beads/main/install.ps1 | iexManual Install:
Download the appropriate binary for your platform below, extract it, and place it in your PATH.
Changelog
Features
- 57e576e Merge PR #2342: feat: surface sync.git-remote in fresh clone error flow
- b3decc2 feat(bd): remove daemon infrastructure (w-bd-001)
- b4b586d feat(doctor): allow suppressing specific warnings via config (GH#1095)
- 7702ebe feat(doctor): detect fresh clone state on Dolt server
- 1ca5e8c feat(dolt): surface sync.git-remote in database-not-found errors
- 4e408bc feat(init): distinguish server-reachable from DB-exists in init guard
- 7f41edd feat(nix): modernize flake for nixpkgs-25.11, fix-merge PR #2314
- 5ea0eaa feat: add OpenCode recipe to bd setup
- 7c8cd89 feat: add version to END marker for better future matching
Bug Fixes
- a9a9c7a Merge PR #2293: fix(deps): update dependency fastmcp to v3
- 6adf14b Merge PR #2300: fix: skip Docker Hub network calls when Dolt image not cached
- 8d3de51 Merge PR #2322: fix(docs): correct misleading examples in QUICKSTART.md
- 3b9ef20 Merge PR #2329: fix(dolt): batch all IN-clause queries to prevent full table scans
- 1be0a41 fix(backup): default git-push to OFF, require explicit opt-in
- 1b26227 fix(backup): default git-push to OFF, require explicit opt-in
- d14bed5 fix(backup): skip git commits during hook runs and on feature branches
- 0b15550 fix(circuit): reduce cooldown to 5s and add active TCP health probe
- 6e9a86f fix(config): route backup.* keys to config.yaml so overrides are respected
- 1b921b9 fix(dep): add cross-prefix routing to dep commands (#2296)
- 5cc48cf fix(deps): update dependency fastmcp to v3
- d3c845c fix(deps): update github.com/dolthub/driver digest to 37b6617
- 2d9ad51 fix(docs): correct misleading examples in QUICKSTART.md
- 431d840 fix(docs): disambiguate duplicate nvim-beads entry in COMMUNITY_TOOLS.md
- 663e13b fix(doctor): correct command order in enrichFreshClone
- 2ba09ad fix(dolt): batch all IN-clause queries to prevent full table scans
- f06795e fix(dolt): gate CLI routing on local remote availability and extend SQL push timeout (#2295)
- c6e4180 fix(dolt): idle-monitor single-instance lock, port config isolation, project UUID verification (GH#2367, GH#2372)
- 11b9568 fix(dolt): retry on serialization error in TestConcurrentIssueCreation
- 515a773 fix(dolt): use database subdirectory for CLI push/pull/fetch operations
- 49ebfa2 fix(dolt): use database subdirectory for CLI push/pull/fetch operations (GH#2311)
- d9a719e fix(doltserver): idle-monitor kills itself via Stop() — watchdog loop fix
- ee6bcef fix(doltserver): log when Start() falls back to DerivePort on collision
- 58f5989 fix(init): prevent data destruction from misleading error messages (GH#2363, GH#2372)
- feaee93 fix(init): use DefaultConfig for port resolution during init (GH#2372)
- 364691f fix(list): make --tree the default display mode for bd list
- 2174032 fix(test): remove more daemon-dependent tests (maxDoltServers, idle monitor)
- 569ca25 fix(test): remove tests for daemon infrastructure removed in b3decc2
- 4e65285 fix(test): remove tests for daemon infrastructure removed in b3decc2
- c8f61cb fix(tests): align tests with cross-type blocking validation
- 16b425e fix: add contributor auto-routing fallback to show/update/close (GH#2345)
- 049ec26 fix: add id tiebreaker to all ORDER BY clauses for deterministic ordering
- 864bbc2 fix: address code review findings for hook marker handling
- a304bc3 fix: commit per batch in deleteWispBatch to avoid write timeout
- b597fa1 fix: config-aware prefix detection in ResolvePartialID
- b1b6835 fix: config-aware prefix detection in ResolvePartialID (GH#2381)
- 4197335 fix: deterministic ordering in SearchIssues and GetReadyWork (GH#2368)
- a489b11 fix: handle orphaned BEGIN marker in injectHookSection (GH#2344)
- 1ec62df fix: handle orphaned BEGIN marker in injectHookSection (GH#2344)
- fade3b1 fix: make bd doctor --fix repair broken hook markers (GH#2344)
- df1e6bb fix: remove dead 3-way merge config remnants (GH#2353)
- 0e286c0 fix: restore DerivePort as standalone default in DefaultConfig
- 2e1ea1e fix: skip Docker Hub network calls when Dolt image not cached (GH#2277)
- bb7be24 fix: skip tombstone entries in bd init --from-jsonl
- c21ffcb fix: warn on user-modified legacy hooks during migration
- daaaf8e fix: warn on user-modified legacy hooks during migration (GH#2370)
Others
- b9c549b /internal/storage/embeddeddolt/store.go: fix formatting
- 7bfa0e4 /internal/storage/embeddeddolt: add store
- 5404b0f /internal/storage/embeddeddolt: handle context canceled in cleanup func
- fb22268 /internal/storage/embeddeddolt: pr feedback
- 45b5e84 /internal/storage/embeddeddolt: refactor to use short-lived access pattern
- f0f66ef /internal/storage/embeddeddolt: wip, add open sql and concurrency test
- 5d159dd Merge PR #2317: Add nvim-beads by fancypantalons to COMMUNITY_TOOLS.md
- 637c817 Merge PR #2318: docs: update GIT_INTEGRATION.md re deprecated beads-merge binary and Jujutsu integration
- 7a53725 Merge PR #2319: docs: add fancypantalons/nvim-beads to Community Tools
- 251680e Merge PR #2369: refactor: remove 3-way merge engine remnants (bd-hhh)
- cd033d5 Merge remote-tracking branch 'origin/polecat/obsidian/bd-m7sy@mmaw77ig'
- f31acbb Remove stale sync mode documentation
- 472fb64 bd: backup 2026-03-05 22:09
- facfd75 bd: backup 2026-03-05 22:24
- 959aa7f chore(testutil): remove unused port field from doltServer struct (bd-m7sy)
- c63c11a ci: retrigger
- f7ad9dd ci: retrigger (PR was briefly closed during prior push)
- 93a934e docs(dolt): deprecate bd migrate --to-dolt in docs
- 95c85e3 docs(doltserver): document birthday-problem collision recovery in DerivePort
- fff12b2 docs(troubleshooting): add circuit breaker and upgrade recovery docs
- 3872308 refactor(tests): migrate all test files from StartTestDoltServer to container-native API
- 76aec3c refactor(testutil): expand Dolt readiness to 5-state enum (#2304)
- 6cb2863 refactor(testutil): remove StartTestDoltServer/TestDoltServer, add crash detection functions
- f4c575e refactor: consolidate ExtractPrefix into types package
- 1838b30 refactor: remove 3-way merge engine remnants (bd-hhh)
- 570becd refactor: remove legacy daemon lock infrastructure
- d878ff9 style: fix gofmt alignment in init_hooks_test.go
- 246b0e8 style: fix gofmt trailing blank lines