beads v0.61.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
- ad0417a Merge PR #2543: feat(dolt): CLI credential pass-through for server mode push/pull
- ef59bd0 Merge PR #2585: feat: auto-detect beads database on git origin during init/bootstrap
- 947d557 Merge PR #2594: feat: add --claim-next to close and --skills/--context to create
- 22ab742 Merge PR #2600: feat: prime SSOT tasks 8-12 — init upgrade, recipe cleanup, symlink safety, staleness detection
- ee4dc91 Merge PR #2600: feat: prime SSOT tasks 8-12 — init upgrade, recipe cleanup, symlink safety, staleness detection
- de5f0b9 Merge PR #2622: feat: add --no-history flag to separate Dolt commit skipping from GC eligibility
- 5689f48 feat(dolt): add CLI credential routing for federation PushTo/PullFrom/Fetch
- 02dc8c8 feat(dolt): add CLI credential routing for server mode push
- 1911d2d feat(dolt): extend CLI credential routing to ForcePush and Pull
- 6edd905 feat(setup): target CLAUDE.md and GEMINI.md for hooks integrations
- 7267cbb feat(setup): target CLAUDE.md and GEMINI.md for hooks integrations
- 93b8529 feat: Claude and Gemini setup install minimal AGENTS.md section (#2139, tasks 5-6)
- 6588c53 feat: Claude and Gemini setup install minimal AGENTS.md section (#2139, tasks 5-6)
- 1ce765e feat: UUID primary keys for federation-safe events
- ecad137 feat: add --claim-next to close and --skills/--context to create
- 869cc17 feat: add --no-history flag to bd create — skip Dolt commits without GC eligibility
- 6673026 feat: add --skip-agents flag and branchless/JJ docs (GH#1335)
- 04799bc feat: add bd import command for incremental JSONL import
- 4d14fb8 feat: auto-detect beads database on git origin during bootstrap
- 05142d0 feat: consolidate prime SSOT section replacement into canonical ReplaceSection (bd-jfe5)
- f79ba31 feat: explicit profile:full on all AGENTS.md integrations (#2139, task 4)
- d115e93 feat: explicit profile:full on all AGENTS.md integrations (#2139, task 4)
- 46816ee feat: prime SSOT tasks 1-3 — shared render API, template profiles, prefix-aware parser (#2139)
- f78b1b2 feat: prime SSOT tasks 1-3 — shared render API, template profiles, prefix-aware parser (#2139)
- a0720f2 feat: prime SSOT tasks 8-12 — init upgrade, recipe cleanup, symlink safety, staleness detection (#2139)
- 809bd43 feat: prime SSOT tasks 8-12 — init upgrade, recipe cleanup, symlink safety, staleness detection (#2139)
Bug Fixes
- 52c9dea Merge PR #2537: fix: respect BD_BACKUP_ENABLED=false to suppress backup commits (GH#2534)
- 91d98f3 Merge PR #2538: fix: bd doctor detects committed runtime/sensitive files (GH#2535)
- 259925c Merge PR #2564: fix(flake): Go 1.25.8 overlay + vendorHash for nix build and devShell
- 17ca46d Merge PR #2567: fix(embeddeddolt): implement more storage methods
- 4a1a7f9 Merge PR #2578: fix: formula extends merges child steps by ID instead of appending
- a39ee2b Merge PR #2578: fix: formula extends merges child steps by ID instead of appending
- 3d1f844 Merge PR #2579: fix(deps): update github.com/dolthub/driver digest to 0fe74e7
- 76b102c Merge PR #2582: fix: allow colons in unquoted query identifier values
- fcef544 Merge PR #2586: fix(doctor): auto-start Dolt on cold standalone checks
- 7017954 Merge PR #2591: fix: applyConfigDefaults uses full port resolution chain
- 62f310c Merge PR #2592: fix: read jira.pull_jql config during FetchIssues
- 393b082 Merge PR #2593: fix: scope KillStaleServers to repo own data directory
- c748838 Merge PR #2597: fix: complete UUID primary keys cleanup
- 82f6a81 Merge PR #2603: fix(deps): update dependency fastmcp to v3.1.1
- 549345f Merge PR #2604: fix: key circuit breaker on host:port instead of port only
- 3436b7c Merge PR #2607: fix(doctor): detect server-backed runtime for concurrency check
- b7ff054 Merge PR #2610: fix(backup): accept UUID comment and event IDs during restore
- 0601fff Merge PR #2616: fix(doctor): use target repo for fingerprint checks
- 66057e6 Merge PR #2618: fix: store credential key in .beads/ to avoid ghost dolt directories
- 81fcf44 fix(deps): update dependency fastmcp to v3.1.1
- 190e70f fix(deps): update github.com/dolthub/driver digest to 0fe74e7
- bc28d83 fix(doctor): auto-start Dolt on cold standalone checks
- ebff84d fix(doctor): detect server-backed runtime for concurrency check
- 65ed43f fix(doctor): honor bare-parent beads dir for gitignore repair (beads-9f74-q9o)
- 9f3603b fix(doctor): honor bare-parent fallback in dolt lock checks (beads-9f74-f5e)
- 94a5524 fix(doctor): use effective beads dir for shared-server checks (beads-9f74-385)
- 66079fd fix(flake): overlay Go 1.25.8 for devShell compatibility
- f320e3c fix(flake): override go_1_25 and fix vendorHash
- fd17ed1 fix(init): warn when server host defaults to localhost
- bb45595 fix: Commit() excludes config table to prevent issue_prefix corruption (GH#2455)
- e9bce23 fix: EnsureRunning skips Start() when explicit port indicates external server
- 2fea62f fix: accept UUID comment and event IDs during restore
- 273c377 fix: add timeout and prompt suppression to git ls-remote probe
- 4856644 fix: allow colons in unquoted query identifier values
- 1b7bb92 fix: applyConfigDefaults uses full port resolution chain
- a45961c fix: bd context reports actual runtime Dolt port instead of default 3307
- 350c050 fix: bd doctor detects committed runtime/sensitive files that should be gitignored (GH#2535)
- d3cf4e9 fix: bd init fails in directories starting with a dot
- 3024c09 fix: bd list ready rejects bare keyword with hint to use --ready (GH#2532) (#2536)
- 7bbd928 fix: clean stale noms LOCK files before opening embedded dolt store
- fca3d3c fix: complete UUID primary keys cleanup across codebase
- cba968e fix: detached commit worktree test fails when default branch is not main
- f286e39 fix: formula extends merges child steps by ID instead of appending
- c36b4ed fix: gofmt import.go and update stale embedded dolt from_jsonl test
- 97fb20b fix: handle BEADS_DB pointing to directory instead of file
- c5cb9f6 fix: handle BEADS_DB pointing to directory instead of file (#2549)
- 3158495 fix: key circuit breaker on host:port instead of port only (bd-ic2)
- 1bb721c fix: make --title, --title-contains, --desc-contains case-insensitive
- c51923d fix: merge user-level config under project config instead of ignoring it (GH#2375)
- 0827ccd fix: migrate server-root remotes to database dir on store open (GH#2118)
- b1b11d2 fix: port-0 circuit breaker poisoning prevention (fix-merge PR #2599)
- fb51196 fix: preserve source rig's dolt_database across .beads/redirect
- ef654a9 fix: prevent comment duplication on re-import
- 41de7e0 fix: read jira.pull_jql config during FetchIssues
- 4b2a3b8 fix: repair broken setupDetachedCommitBeadsWorktree test helper
- c741e8a fix: respect BD_BACKUP_ENABLED=false to suppress backup commits (GH#2534)
- 57d83d8 fix: scope KillStaleServers to only kill processes from this repo's data directory
- e21d768 fix: scope backup/restore to current project prefix
- 6a1391e fix: skip empty backup/issues.jsonl so git-tracked JSONL wins
- 8c770af fix: stop auto-started dolt servers on DoltStore.Close()
- 3a1d57a fix: store credential key in .beads/ to avoid ghost dolt directories (bd-cby)
- e12502b fix: suppress gosec G304 for resolved agent path
- def866d fix: suppress gosec G304 for resolved agent path
- fca2d29 fix: sync agents.md.tmpl beads section with beads-section.md
- 0e00e8d fix: sync agents.md.tmpl beads section with beads-section.md
- 86861b6 fix: update doctor test version expectations for v0.60.0
Others
- 465b4b0 /.github/workflows/ci.yml: test embeddeddolt on pr
- 6232679 /cmd/bd/create.go: pr feedback
- 7235f36 /cmd/bd/init_embedded_test.go: reduce test file lines
- 2dec384 /cmd/bd/init_embedded_test.go: wip, found dolt bug
- 5c078a0 /cmd/bd/{doctor,init}.go: skip initDiagnostics with embedded dolt
- ba1fc22 /internal/storage/embeddeddolt/store.go: fix with conn
- b105a47 /internal/storage/embeddeddolt: add create_issue.go, some refactoring
- ad05d72 /internal/storage/embeddeddolt: implement computeBlockedIDs
- 402a681 /internal/storage/issueops/helpers.go: fix isWisp
- c07a3cd /internal/storage/{embeddeddolt,issueops}: add issueops helper to use in both stores
- facc18b /internal/storage/{embeddeddolt,issueops}: fix GetIssue
- 1ed8599 /internal/storage/{embeddeddolt,issueops}: fix method implementations
- b0e9719 /internal/storage/{embeddeddolt,issueops}: implement more methods needed for bd create
- c0a702a /internal/storage/{embeddeddolt,issueops}: pr feedback
- 220916b /internal/storage/{embeddeddolt,issueops}: pr feedback
- 4f48bf5 /{cmd,internal}: add lock for init, adjust test
- 22c9d56 /{cmd,internal}: address pr feedback
- 10a30c6 /{cmd,internal}: fix bd init output
- 4c6b5c1 /{cmd,internal}: restore dolt commit in issue methods
- ba10c7b /{cmd,internal}: update DoltStore to use shared issueops library code
- 4a33a4b /{cmd,internal}: wip, need concurrent init tests
- f7bcd79 Add backup export-git command (bd-jx5t5)
- 6f0e220 Add backup fetch-git and git snapshot follow-ups (bd-mtqql)
- 3034015 Add backup fetch-git and git snapshot manifest (bd-vogvt)
- e055814 DRY backup git helpers (bd-cm220)
- e5b8aee Fix bd doctor bare-parent fallback checks
- 61f7697 Fix broken detached commit worktree test helper (#2551)
- af4d374 Fix doctor target-path repo fingerprint resolution (beads-upstream-103)
- 7cf21eb Merge PR #2541: cmd/bd: teach bd prime to use --claim
- 2c5cfcb Merge PR #2552: docs: replace git-backed with Dolt-powered, document git-free usage
- d55077b Merge PR #2568: docs: move stale community tools to historical section
- 56e331d Merge PR #2587: Fix: scope backup/restore to current project prefix
- 861929b Merge PR #2596: Preserve repo-local Dolt servers during stale cleanup
- f9a6831 Merge PR #2613: backup: add fetch-git and clean up JSONL backup docs
- 14343da Merge PR #2621: Harden install trust model and clarify security guidance
- 0952ffb Preserve repo-local Dolt servers during stale cleanup (GH#2595)
- 32ed0bb Support bare-parent worktree beads fallback
- 935096f Teach bd prime to use atomic claim guidance
- cddbe39 Update beads skill to v0.60.0 + Anthropic 2026 spec compliance
- 4d23a6c harden installers and docs for transparent trust model (GH#1857)
- 7ff5406 refactor: init uses RenderSection with profile metadata (#2139, task 7)
- 8e7da25 refactor: init uses RenderSection with profile metadata (#2139, task 7)
- 87b6bea style: fix gofmt formatting
- 8b2df91 style: fix gofmt formatting
- 21f0ff9 style: fix gofmt formatting in import.go and store.go
- 3f8f400 style: fix gofmt on import.go (pre-existing)
- 0b3ddd3 style: satisfy repo gofmt baseline