Beads Files

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):

:::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

• [ad0417] Merge PR [#2543]: feat(dolt): CLI credential pass-through for server mode push/pull
• [ef59bd] Merge PR [#2585]: feat: auto-detect beads database on git origin during init/bootstrap
• [947d55] Merge PR [#2594]: feat: add --claim-next to close and --skills/--context to create
• [22ab74] Merge PR [#2600]: feat: prime SSOT tasks 8-12 — init upgrade, recipe cleanup, symlink safety, staleness detection
• [ee4dc9] Merge PR [#2600]: feat: prime SSOT tasks 8-12 — init upgrade, recipe cleanup, symlink safety, staleness detection
• [de5f0b] Merge PR [#2622]: feat: add --no-history flag to separate Dolt commit skipping from GC eligibility
• [5689f4] feat(dolt): add CLI credential routing for federation PushTo/PullFrom/Fetch
• [02dc8c] feat(dolt): add CLI credential routing for server mode push
• [1911d2] feat(dolt): extend CLI credential routing to ForcePush and Pull
• [6edd90] feat(setup): target CLAUDE.md and GEMINI.md for hooks integrations
• [7267cb] feat(setup): target CLAUDE.md and GEMINI.md for hooks integrations
• [93b852] feat: Claude and Gemini setup install minimal AGENTS.md section (#2139, tasks 5-6)
• [6588c5] feat: Claude and Gemini setup install minimal AGENTS.md section (#2139, tasks 5-6)
• [1ce765] feat: UUID primary keys for federation-safe events
• [ecad13] feat: add --claim-next to close and --skills/--context to create
• [869cc1] feat: add --no-history flag to bd create — skip Dolt commits without GC eligibility
• [667302] feat: add --skip-agents flag and branchless/JJ docs (GH#1335)
• [04799b] feat: add bd import command for incremental JSONL import
• [4d14fb] feat: auto-detect beads database on git origin during bootstrap
• [05142d] feat: consolidate prime SSOT section replacement into canonical ReplaceSection (bd-jfe5)
• [f79ba3] feat: explicit profile:full on all AGENTS.md integrations (#2139, task 4)
• [d115e9] feat: explicit profile:full on all AGENTS.md integrations (#2139, task 4)
• [46816e] feat: prime SSOT tasks 1-3 — shared render API, template profiles, prefix-aware parser (#2139)
• [f78b1b] feat: prime SSOT tasks 1-3 — shared render API, template profiles, prefix-aware parser (#2139)
• [a0720f] feat: prime SSOT tasks 8-12 — init upgrade, recipe cleanup, symlink safety, staleness detection (#2139)
• [809bd4] feat: prime SSOT tasks 8-12 — init upgrade, recipe cleanup, symlink safety, staleness detection (#2139)

Bug Fixes

• [52c9de] Merge PR [#2537]: fix: respect BD_BACKUP_ENABLED=false to suppress backup commits (GH#2534)
• [91d98f] Merge PR [#2538]: fix: bd doctor detects committed runtime/sensitive files (GH#2535)
• [259925] Merge PR [#2564]: fix(flake): Go 1.25.8 overlay + vendorHash for nix build and devShell
• [17ca46] Merge PR [#2567]: fix(embeddeddolt): implement more storage methods
• [4a1a7f] Merge PR [#2578]: fix: formula extends merges child steps by ID instead of appending
• [a39ee2] Merge PR [#2578]: fix: formula extends merges child steps by ID instead of appending
• [3d1f84] Merge PR [#2579]: fix(deps): update github.com/dolthub/driver digest to 0fe74e7
• [76b102] Merge PR [#2582]: fix: allow colons in unquoted query identifier values
• [fcef54] Merge PR [#2586]: fix(doctor): auto-start Dolt on cold standalone checks
• [701795] Merge PR [#2591]: fix: applyConfigDefaults uses full port resolution chain
• [62f310] Merge PR [#2592]: fix: read jira.pull_jql config during FetchIssues
• [393b08] Merge PR [#2593]: fix: scope KillStaleServers to repo own data directory
• [c74883] Merge PR [#2597]: fix: complete UUID primary keys cleanup
• [82f6a8] Merge PR [#2603]: fix(deps): update dependency fastmcp to v3.1.1
• [549345] Merge PR [#2604]: fix: key circuit breaker on host:port instead of port only
• [3436b7] Merge PR [#2607]: fix(doctor): detect server-backed runtime for concurrency check
• [b7ff05] Merge PR [#2610]: fix(backup): accept UUID comment and event IDs during restore
• [0601ff] Merge PR [#2616]: fix(doctor): use target repo for fingerprint checks
• [66057e] Merge PR [#2618]: fix: store credential key in .beads/ to avoid ghost dolt directories
• [81fcf4] fix(deps): update dependency fastmcp to v3.1.1
• [190e70] fix(deps): update github.com/dolthub/driver digest to 0fe74e7
• [bc28d8] fix(doctor): auto-start Dolt on cold standalone checks
• [ebff84] fix(doctor): detect server-backed runtime for concurrency check
• [65ed43] fix(doctor): honor bare-parent beads dir for gitignore repair (beads-9f74-q9o)
• [9f3603] fix(doctor): honor bare-parent fallback in dolt lock checks (beads-9f74-f5e)
• [94a552] fix(doctor): use effective beads dir for shared-server checks (beads-9f74-385)
• [66079f] fix(flake): overlay Go 1.25.8 for devShell compatibility
• [f320e3] fix(flake): override go_1_25 and fix vendorHash
• [fd17ed] fix(init): warn when server host defaults to localhost
• [bb4559] fix: Commit() excludes config table to prevent issue_prefix corruption (GH#2455)
• [e9bce2] fix: EnsureRunning skips Start() when explicit port indicates external server
• [2fea62] fix: accept UUID comment and event IDs during restore
• [273c37] fix: add timeout and prompt suppression to git ls-remote probe
• [485664] fix: allow colons in unquoted query identifier values
• [1b7bb9] fix: applyConfigDefaults uses full port resolution chain
• [a45961] fix: bd context reports actual runtime Dolt port instead of default 3307
• [350c05] fix: bd doctor detects committed runtime/sensitive files that should be gitignored (GH#2535)
• [d3cf4e] fix: bd init fails in directories starting with a dot
• [3024c0] fix: bd list ready rejects bare keyword with hint to use --ready (GH#2532) (#2536)
• [7bbd92] fix: clean stale noms LOCK files before opening embedded dolt store
• [fca3d3] fix: complete UUID primary keys cleanup across codebase
• [cba968] fix: detached commit worktree test fails when default branch is not main
• [f286e3] fix: formula extends merges child steps by ID instead of appending
• [c36b4e] fix: gofmt import.go and update stale embedded dolt from_jsonl test
• [97fb20] fix: handle BEADS_DB pointing to directory instead of file
• [c5cb9f] fix: handle BEADS_DB pointing to directory instead of file (#2549)
• [315849] fix: key circuit breaker on host:port instead of port only (bd-ic2)
• [1bb721] fix: make --title, --title-contains, --desc-contains case-insensitive
• [c51923] fix: merge user-level config under project config instead of ignoring it (GH#2375)
• [0827cc] fix: migrate server-root remotes to database dir on store open (GH#2118)
• [b1b11d] fix: port-0 circuit breaker poisoning prevention (fix-merge PR [#2599])
• [fb5119] fix: preserve source rig's dolt_database across .beads/redirect
• [ef654a] fix: prevent comment duplication on re-import
• [41de7e] fix: read jira.pull_jql config during FetchIssues
• [4b2a3b] fix: repair broken setupDetachedCommitBeadsWorktree test helper
• [c741e8] fix: respect BD_BACKUP_ENABLED=false to suppress backup commits (GH#2534)
• [57d83d] fix: scope KillStaleServers to only kill processes from this repo's data directory
• [e21d76] fix: scope backup/restore to current project prefix
• [6a1391] fix: skip empty backup/issues.jsonl so git-tracked JSONL wins
• [8c770a] fix: stop auto-started dolt servers on DoltStore.Close()
• [3a1d57] fix: store credential key in .beads/ to avoid ghost dolt directories (bd-cby)
• [e12502] fix: suppress gosec G304 for resolved agent path
• [def866] fix: suppress gosec G304 for resolved agent path
• [fca2d2] fix: sync agents.md.tmpl beads section with beads-section.md
• [0e00e8] fix: sync agents.md.tmpl beads section with beads-section.md
• [86861b] fix: update doctor test version expectations for v0.60.0

Others

• [465b4b] /.github/workflows/ci.yml: test embeddeddolt on pr
• [623267] /cmd/bd/create.go: pr feedback
• [7235f3] /cmd/bd/init_embedded_test.go: reduce test file lines
• [2dec38] /cmd/bd/init_embedded_test.go: wip, found dolt bug
• [5c078a] /cmd/bd/{doctor,init}.go: skip initDiagnostics with embedded dolt
• [ba1fc2] /internal/storage/embeddeddolt/store.go: fix with conn
• [b105a4] /internal/storage/embeddeddolt: add create_issue.go, some refactoring
• [ad05d7] /internal/storage/embeddeddolt: implement computeBlockedIDs
• [402a68] /internal/storage/issueops/helpers.go: fix isWisp
• [c07a3c] /internal/storage/{embeddeddolt,issueops}: add issueops helper to use in both stores
• [facc18] /internal/storage/{embeddeddolt,issueops}: fix GetIssue
• [1ed859] /internal/storage/{embeddeddolt,issueops}: fix method implementations
• [b0e971] /internal/storage/{embeddeddolt,issueops}: implement more methods needed for bd create
• [c0a702] /internal/storage/{embeddeddolt,issueops}: pr feedback
• [220916] /internal/storage/{embeddeddolt,issueops}: pr feedback
• [4f48bf] /{cmd,internal}: add lock for init, adjust test
• [22c9d5] /{cmd,internal}: address pr feedback
• [10a30c] /{cmd,internal}: fix bd init output
• [4c6b5c] /{cmd,internal}: restore dolt commit in issue methods
• [ba10c7] /{cmd,internal}: update DoltStore to use shared issueops library code
• [4a33a4] /{cmd,internal}: wip, need concurrent init tests
• [f7bcd7] Add backup export-git command (bd-jx5t5)
• [6f0e22] Add backup fetch-git and git snapshot follow-ups (bd-mtqql)
• [303401] Add backup fetch-git and git snapshot manifest (bd-vogvt)
• [e05581] DRY backup git helpers (bd-cm220)
• [e5b8ae] Fix bd doctor bare-parent fallback checks
• [61f769] Fix broken detached commit worktree test helper (#2551)
• [af4d37] Fix doctor target-path repo fingerprint resolution (beads-upstream-103)
• [7cf21e] Merge PR [#2541]: cmd/bd: teach bd prime to use --claim
• [2c5cfc] Merge PR [#2552]: docs: replace git-backed with Dolt-powered, document git-free usage
• [d55077] Merge PR [#2568]: docs: move stale community tools to historical section
• [56e331] Merge PR [#2587]: Fix: scope backup/restore to current project prefix
• [861929] Merge PR [#2596]: Preserve repo-local Dolt servers during stale cleanup
• [f9a683] Merge PR [#2613]: backup: add fetch-git and clean up JSONL backup docs
• [14343d] Merge PR [#2621]: Harden install trust model and clarify security guidance
• [0952ff] Preserve repo-local Dolt servers during stale cleanup (GH#2595)
• [32ed0b] Support bare-parent worktree beads fallback
• [935096] Teach bd prime to use atomic claim guidance
• [cddbe3] Update beads skill to v0.60.0 + Anthropic 2026 spec compliance
• [4d23a6] harden installers and docs for transparent trust model (GH#1857)
• [7ff540] refactor: init uses RenderSection with profile metadata (#2139, task 7)
• [8e7da2] refactor: init uses RenderSection with profile metadata (#2139, task 7)
• [87b6be] style: fix gofmt formatting
• [8b2df9] style: fix gofmt formatting
• [21f0ff] style: fix gofmt formatting in import.go and store.go
• [3f8f40] style: fix gofmt on import.go (pre-existing)
• [0b3ddd] style: satisfy repo gofmt baseline