beads v0.62.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
- 6724965 Merge PR #2638: feat: add --format json alias for --json flag
- 39ab50d feat(ado): add Azure DevOps work item tracker package
- 9f5741f feat(ado): add bd ado CLI commands (sync, status, projects)
- 9a8aa55 feat(embeddeddolt): add embedded Dolt support for dep, duplicate, epic, graph, supersede, swarm (fix-merge PR #2734)
- a44ecef feat(init): default AGENTS.md to minimal profile, add --agents-profile flag
- 5f2d433 feat: add 'bd note' command as shorthand for appending notes
- affb314 feat: add --exclude-type flag to bd ready and bd list
- d6e5a5f feat: add --format json alias for --json flag
- faa69f9 feat: audit log captures close reason; add v0.62.0 changelog and version notes
- a44e01e feat: audit log status changes to interactions.jsonl (bd-42f)
- 9b2c012 feat: custom status categories (active/wip/done/frozen)
- fab29b0 feat: expose issue_type filter on MCP ready tool (PR #2660)
- a22af2d feat: include memories in export/import round-trip
- 0fe9c03 feat: surface quality/lifecycle commands in prime, template, and doctor (fix-merge PR #2664)
Bug Fixes
- 679d7bf Merge PR #2651: fix: use go run for golangci-lint in pre-commit hook
- ae28719 fix(ci): add write permissions to update-flake-lock workflow (PR #2642)
- c847353 fix(cli): keep repo .beads config when dolt_data_dir escapes
- e566d3a fix(config): route config unset to correct store (GH#2727)
- 4a5cb16 fix(deps): update dolthub/driver v0.2.1 to v1.83.8 (fix-merge PR #2720)
- e6ee4f9 fix(deps): update github.com/anthropics/anthropic-sdk-go to v1.27.1 (PR #2705)
- 51d41e2 fix(deps): update github.com/dolthub/driver digest to 1f97424 (PR #2650)
- 164cea7 fix(doctor): add dolt-server.activity to gitignore, prioritize gitignore fixes (GH#2723)
- c3ee79e fix(doctor): fail closed for server-mode integrity recovery
- e2f9f51 fix(dolt): bump schema version to 8 and commit version update (PR #2635)
- 87c8985 fix(dolt): keep repo-local auto-started servers alive across commands
- 60dd444 fix(dolt): verify dolt_status is clean after schema upgrade (GH#2634)
- 71a0360 fix(hooks): increase shim timeout from 30s to 300s for chained hooks (GH#2732)
- ec18969 fix(init): add .beads-credential-key to project-root .gitignore (GH#2695)
- 8225a14 fix(init): add TTL to circuit breaker state and clean stale files during init
- 0423e25 fix(mol): add cycle detection to bond traversal to prevent OOM (GH#2719)
- f8152a1 fix(update): require explicit opt-in for empty stdin/file DESCRIPTION rewrites
- 63432ac fix: --validate checks --acceptance field, add validation.on-close config (PR #2654)
- 468c863 fix: Windows Dolt server lifecycle — stale state files and false auto-stop warning (GH#2670)
- ecf15d9 fix: add .beads-credential-key to .gitignore template (PR #2681)
- f535a18 fix: add no_history column to embedded Dolt base schemas (PR #2632)
- 5b9e65d fix: add retry loop for Windows binary existence check after zip extraction (fix-merge PR #2753)
- e650b1f fix: add warnings for silent database name fallback in main command path
- e67a574 fix: bootstrap imports from git-tracked .beads/issues.jsonl
- fabda03 fix: check BEADS_DOLT_SERVER_DATABASE env var in applyConfigDefaults
- 2846af3 fix: correct bd human help text for adding comments (fix-merge PR #2752)
- 0e13cb5 fix: correct version ordering in versionChanges (PR #2633)
- 2aff244 fix: don't kill externally-managed dolt servers (GH#2641)
- d56d290 fix: drop id from ORDER BY in GetAllEventsSince UNION ALL query (PR #2691)
- f20b3d0 fix: load .beads/.env before noDbCommands early return
- 93bfd45 fix: load .beads/.env before noDbCommands early return (GH#2677)
- fe1c9d5 fix: make KillStaleServers respect server ownership
- b70f740 fix: mark unused cfg param in checkProjectIdentityNoStore
- 2db73f8 fix: merge duplicate v0.60.0 changelog entries into single block
- b272e0b fix: pass repo path through fingerprint check to fix merge with main
- 76bfcd3 fix: preserve all hooks when overriding core.hooksPath, not just managed ones
- a153b13 fix: preserve pre-existing hooks when bd init sets core.hooksPath
- c75c2b5 fix: prevent doctor infinite Dolt server restart loop (GH#2636)
- a683dbc fix: prevent silent fallback to default "beads" database in openDoltDB
- 332f641 fix: remove duplicate TestCompactTier1_DryRun (PR #2631)
- 6468766 fix: remove hardcoded ~/gt/ paths from beads codebase (bd-h615)
- 059ee44 fix: remove unnecessary type conversions in find_duplicates.go
- cb98259 fix: remove unnecessary type conversions in find_duplicates.go
- f442c08 fix: remove unnecessary type conversions in find_duplicates.go
- b89f1b3 fix: remove unnecessary type conversions in find_duplicates.go
- e88379f fix: remove unnecessary type conversions in haiku.go
- 1142460 fix: remove unnecessary type conversions in haiku.go
- 32d4178 fix: remove unnecessary type conversions in haiku.go
- 95dfaf0 fix: remove unnecessary type conversions in haiku.go
- 43df89b fix: repair nightly integration test compilation failures
- dc180dd fix: replace broken SQL CAST in GetNextChildIDTx with Go-side parsing (GH#2721)
- bcfa8a7 fix: resolve --format json collision between rootCmd persistent flag and list/dep-tree local flags
- f73a9ca fix: serialize concurrent initSchemaOnDB with GET_LOCK to prevent journal corruption (#2672)
- 21fe42e fix: suppress gosec G304 for filepath.Glob-sourced path in circuit breaker cleanup
- c9d7730 fix: update test_stats fixture to match nested Stats model (PR #2659)
- 811d736 fix: use SHOW COLUMNS in uuid_primary_keys migration to avoid server-mode crash (fix-merge PR #2751)
- c4fbe1e fix: use SQL stored procedures for bd flatten/compact in server mode (bd-uty)
- 6d1777a fix: use go run for golangci-lint in pre-commit hook
Others
- 02c59bc /.github/workflows/ci.yml: skip build step
- 4523b77 /cmd/bd/count_embedded_test.go: count tests
- 778975c /cmd/bd/diff_embedded_test.go: diff tests
- 44a95b3 /cmd/bd/find_duplicates_embedded_test.go: test
- 70e7d9e /cmd/bd/gate_embedded_test.go: gate test
- 18136bc /cmd/bd/init_embedded_test.go: fix test
- 4b26c76 /cmd/bd/label_embedded_test.go: add label tests
- 5b9546c /cmd/bd/list_embedded_test.go: formatting
- 555f4b5 /cmd/bd/merge_slot_embedded_test.go: merge slot
- e7a4922 /cmd/bd/move_embedded_test.go: move slot
- 9273ddf /cmd/bd/promote_embedded_test.go: promote test
- 01c193e /cmd/bd/query_embedded_test.go: add query test
- 2163689 /cmd/bd/quick_embedded_test.go: quick test
- ed6551d /cmd/bd/search_embedded_test.go: search test
- 06be1de /cmd/bd/show_embedded_test.go: add show test
- bbf520a /cmd/bd/update_close_embedded_test.go: concurrency tests
- b55bba8 /cmd/bd/update_close_embedded_test.go: more tests
- 784d803 /cmd/bd/update_close_embedded_test.go: tests
- c875268 /cmd/bd/{diff,history}: fix comment
- 3f12738 /cmd/bd/{init,main}: some fixes
- 792298f /cmd/bd: add other tests
- fda1e49 /cmd/bd: add tests for the remaining
- 188ba0e /cmd/bd: commit on write commands
- f0b2b70 /cmd/bd: do type check
- a0da53c /cmd/bd: pr feedback
- d1eb23a /cmd/bd: split test files
- bdca3dc /go.{mod,sum}: bump driver
- 180771d /internal/storage/dolt: pr feedback
- fb123fc /internal/storage/dolt: remove comment
- e019755 /internal/storage/dolt: use issuops
- 5c7e764 /internal/storage/embeddeddolt/schema: remove no_history migration changes
- 7eca4d4 /internal/storage/embeddeddolt: add new migration
- b9f32e2 /internal/storage/issueops: fix queries
- 4eeb5f6 /internal/storage/issueops: pr feedback
- 7c63af9 /internal/storage/{dolt, embeddeddolt}: prep for update close
- e366735 /internal/storage/{dolt,embeddeddolt,issueops}: implement methods
- 9f34d4b /internal/storage/{dolt,embeddeddolt,issueops}: implement methods needed for list
- 2119ce9 /internal/storage/{dolt,embeddeddolt,issueops}: prep update close
- 31c0f2d /internal/storage/{dolt,issueops}: update doltstore to use library code
- 3d7f9d3 /internal/storage/{embeddeddolt,issuops}: refactor
- ceae18d /internal/storage: pr feedback
- de6ce73 /internal/storage:{dolt,embeddeddolt,issueops}: migrate metadata commands
- afb6e44 /{cmd,internal}: add test and commit pending
- e916151 /{cmd,internal}: embeddeddolt list
- 0350e8b /{cmd,internal}: fix commands
- e04beea /{cmd,internal}: fix panic
- 5f022d5 /{cmd,internal}: implement as of
- 15b6190 /{cmd,internal}: implement more methods
- c36c5fc /{cmd,internal}: maybe create
- e7a77a2 /{cmd,internal}: pr feedback
- 92e25d1 /{cmd,internal}: pr feedback
- a693ac4 /{cmd,internal}: pr feedback
- d6c54cb /{cmd,internal}: refactor again
- 9096e6e /{cmd,internal}: remove unneeded stuff
- bc286d8 /{cmd,internal}: update and close issue methods
- 58915b1 /{cmd,internal}: update global store to be interface
- 35d847a Update untrue comment
- bc4ca1e chore(deps): bump github.com/anthropics/anthropic-sdk-go to v1.27.0 (PR #2649)
- e67a054 cmd/bd/list_embedded_test.go: fix test
- 840e421 cmd/bd/list_embedded_test.go: fix text
- 0857ce8 cmd/bd: fix list tests
- 3af3ea1 fix(cmd/bd): preserve repo config when reopening stores by path (PR #2628)
- 389f979 perf: cache doctor beads dir resolution (PR #2643)
- 9e17dbf refactor(doltserver): introduce ServerMode enum to consolidate server ownership inference
- cf8513a refactor: clean up residual sync.mode references (PR #2661)
- 13a83b0 refactor: make BEADS_ACTOR primary env var, BD_ACTOR deprecated fallback (bd-hm9r)
- 5d87e3a refactor: remove GUPP references from beads codebase (bd-5zkx)
- 54dc399 refactor: remove HOP fields from beads schema (bd-vcps)
- 1597379 refactor: remove agent role config categories from beads (bd-lvdl)
- 0bd598c refactor: remove agent-as-bead subsystem from beads (bd-4vw2)
- 3dae6bb refactor: remove gastown/Gas Town string references from beads code and docs (bd-1ue8)
- 655dc3e refactor: remove patrol molecule references from beads commands (bd-74p3)
- 8f18302 refactor: remove polecat/crew/gastown GT terminology from beads types (bd-77g2)
- d6d11c8 refactor: remove polecat/crew/overseer GT terminology from beads types (bd-77g2)
- d8af81e refactor: replace GT_ROLE parsing with BD_ACTOR in hooks (bd-b4q6)
- e66ee1d style: fix gofmt formatting in doltserver.go
- 0838b09 {cmd,internal}: implement method