Beads Files

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

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

• [672496] Merge PR [#2638]: feat: add --format json alias for --json flag
• [39ab50] feat(ado): add Azure DevOps work item tracker package
• [9f5741] feat(ado): add bd ado CLI commands (sync, status, projects)
• [9a8aa5] feat(embeddeddolt): add embedded Dolt support for dep, duplicate, epic, graph, supersede, swarm (fix-merge PR [#2734])
• [a44ece] feat(init): default AGENTS.md to minimal profile, add --agents-profile flag
• [5f2d43] feat: add 'bd note' command as shorthand for appending notes
• [affb31] feat: add --exclude-type flag to bd ready and bd list
• [d6e5a5] feat: add --format json alias for --json flag
• [faa69f] feat: audit log captures close reason; add v0.62.0 changelog and version notes
• [a44e01] feat: audit log status changes to interactions.jsonl (bd-42f)
• [9b2c01] feat: custom status categories (active/wip/done/frozen)
• [fab29b] feat: expose issue_type filter on MCP ready tool (PR [#2660])
• [a22af2] feat: include memories in export/import round-trip
• [0fe9c0] feat: surface quality/lifecycle commands in prime, template, and doctor (fix-merge PR [#2664])

Bug Fixes

• [679d7b] Merge PR [#2651]: fix: use go run for golangci-lint in pre-commit hook
• [ae2871] fix(ci): add write permissions to update-flake-lock workflow (PR [#2642])
• [c84735] fix(cli): keep repo .beads config when dolt_data_dir escapes
• [e566d3] fix(config): route config unset to correct store (GH#2727)
• [4a5cb1] fix(deps): update dolthub/driver v0.2.1 to v1.83.8 (fix-merge PR [#2720])
• [e6ee4f] fix(deps): update github.com/anthropics/anthropic-sdk-go to v1.27.1 (PR [#2705])
• [51d41e] fix(deps): update github.com/dolthub/driver digest to 1f97424 (PR [#2650])
• [164cea] fix(doctor): add dolt-server.activity to gitignore, prioritize gitignore fixes (GH#2723)
• [c3ee79] fix(doctor): fail closed for server-mode integrity recovery
• [e2f9f5] fix(dolt): bump schema version to 8 and commit version update (PR [#2635])
• [87c898] fix(dolt): keep repo-local auto-started servers alive across commands
• [60dd44] fix(dolt): verify dolt_status is clean after schema upgrade (GH#2634)
• [71a036] fix(hooks): increase shim timeout from 30s to 300s for chained hooks (GH#2732)
• [ec1896] fix(init): add .beads-credential-key to project-root .gitignore (GH#2695)
• [8225a1] fix(init): add TTL to circuit breaker state and clean stale files during init
• [0423e2] fix(mol): add cycle detection to bond traversal to prevent OOM (GH#2719)
• [f8152a] fix(update): require explicit opt-in for empty stdin/file DESCRIPTION rewrites
• [63432a] fix: --validate checks --acceptance field, add validation.on-close config (PR [#2654])
• [468c86] fix: Windows Dolt server lifecycle — stale state files and false auto-stop warning (GH#2670)
• [ecf15d] fix: add .beads-credential-key to .gitignore template (PR [#2681])
• [f535a1] fix: add no_history column to embedded Dolt base schemas (PR [#2632])
• [5b9e65] fix: add retry loop for Windows binary existence check after zip extraction (fix-merge PR [#2753])
• [e650b1] fix: add warnings for silent database name fallback in main command path
• [e67a57] fix: bootstrap imports from git-tracked .beads/issues.jsonl
• [fabda0] fix: check BEADS_DOLT_SERVER_DATABASE env var in applyConfigDefaults
• [2846af] fix: correct bd human help text for adding comments (fix-merge PR [#2752])
• [0e13cb] fix: correct version ordering in versionChanges (PR [#2633])
• [2aff24] fix: don't kill externally-managed dolt servers (GH#2641)
• [d56d29] fix: drop id from ORDER BY in GetAllEventsSince UNION ALL query (PR [#2691])
• [f20b3d] fix: load .beads/.env before noDbCommands early return
• [93bfd4] fix: load .beads/.env before noDbCommands early return (GH#2677)
• [fe1c9d] fix: make KillStaleServers respect server ownership
• [b70f74] fix: mark unused cfg param in checkProjectIdentityNoStore
• [2db73f] fix: merge duplicate v0.60.0 changelog entries into single block
• [b272e0] fix: pass repo path through fingerprint check to fix merge with main
• [76bfcd] fix: preserve all hooks when overriding core.hooksPath, not just managed ones
• [a153b1] fix: preserve pre-existing hooks when bd init sets core.hooksPath
• [c75c2b] fix: prevent doctor infinite Dolt server restart loop (GH#2636)
• [a683db] fix: prevent silent fallback to default "beads" database in openDoltDB
• [332f64] fix: remove duplicate TestCompactTier1_DryRun (PR [#2631])
• [646876] fix: remove hardcoded ~/gt/ paths from beads codebase (bd-h615)
• [059ee4] fix: remove unnecessary type conversions in find_duplicates.go
• [cb9825] fix: remove unnecessary type conversions in find_duplicates.go
• [f442c0] fix: remove unnecessary type conversions in find_duplicates.go
• [b89f1b] fix: remove unnecessary type conversions in find_duplicates.go
• [e88379] fix: remove unnecessary type conversions in haiku.go
• [114246] fix: remove unnecessary type conversions in haiku.go
• [32d417] fix: remove unnecessary type conversions in haiku.go
• [95dfaf] fix: remove unnecessary type conversions in haiku.go
• [43df89] fix: repair nightly integration test compilation failures
• [dc180d] fix: replace broken SQL CAST in GetNextChildIDTx with Go-side parsing (GH#2721)
• [bcfa8a] fix: resolve --format json collision between rootCmd persistent flag and list/dep-tree local flags
• [f73a9c] fix: serialize concurrent initSchemaOnDB with GET_LOCK to prevent journal corruption (#2672)
• [21fe42] fix: suppress gosec G304 for filepath.Glob-sourced path in circuit breaker cleanup
• [c9d773] fix: update test_stats fixture to match nested Stats model (PR [#2659])
• [811d73] fix: use SHOW COLUMNS in uuid_primary_keys migration to avoid server-mode crash (fix-merge PR [#2751])
• [c4fbe1] fix: use SQL stored procedures for bd flatten/compact in server mode (bd-uty)
• [6d1777] fix: use go run for golangci-lint in pre-commit hook

Others

• [02c59b] /.github/workflows/ci.yml: skip build step
• [4523b7] /cmd/bd/count_embedded_test.go: count tests
• [778975] /cmd/bd/diff_embedded_test.go: diff tests
• [44a95b] /cmd/bd/find_duplicates_embedded_test.go: test
• [70e7d9] /cmd/bd/gate_embedded_test.go: gate test
• [18136b] /cmd/bd/init_embedded_test.go: fix test
• [4b26c7] /cmd/bd/label_embedded_test.go: add label tests
• [5b9546] /cmd/bd/list_embedded_test.go: formatting
• [555f4b] /cmd/bd/merge_slot_embedded_test.go: merge slot
• [e7a492] /cmd/bd/move_embedded_test.go: move slot
• [9273dd] /cmd/bd/promote_embedded_test.go: promote test
• [01c193] /cmd/bd/query_embedded_test.go: add query test
• [216368] /cmd/bd/quick_embedded_test.go: quick test
• [ed6551] /cmd/bd/search_embedded_test.go: search test
• [06be1d] /cmd/bd/show_embedded_test.go: add show test
• [bbf520] /cmd/bd/update_close_embedded_test.go: concurrency tests
• [b55bba] /cmd/bd/update_close_embedded_test.go: more tests
• [784d80] /cmd/bd/update_close_embedded_test.go: tests
• [c87526] /cmd/bd/{diff,history}: fix comment
• [3f1273] /cmd/bd/{init,main}: some fixes
• [792298] /cmd/bd: add other tests
• [fda1e4] /cmd/bd: add tests for the remaining
• [188ba0] /cmd/bd: commit on write commands
• [f0b2b7] /cmd/bd: do type check
• [a0da53] /cmd/bd: pr feedback
• [d1eb23] /cmd/bd: split test files
• [bdca3d] /go.{mod,sum}: bump driver
• [180771] /internal/storage/dolt: pr feedback
• [fb123f] /internal/storage/dolt: remove comment
• [e01975] /internal/storage/dolt: use issuops
• [5c7e76] /internal/storage/embeddeddolt/schema: remove no_history migration changes
• [7eca4d] /internal/storage/embeddeddolt: add new migration
• [b9f32e] /internal/storage/issueops: fix queries
• [4eeb5f] /internal/storage/issueops: pr feedback
• [7c63af] /internal/storage/{dolt, embeddeddolt}: prep for update close
• [e36673] /internal/storage/{dolt,embeddeddolt,issueops}: implement methods
• [9f34d4] /internal/storage/{dolt,embeddeddolt,issueops}: implement methods needed for list
• [2119ce] /internal/storage/{dolt,embeddeddolt,issueops}: prep update close
• [31c0f2] /internal/storage/{dolt,issueops}: update doltstore to use library code
• [3d7f9d] /internal/storage/{embeddeddolt,issuops}: refactor
• [ceae18] /internal/storage: pr feedback
• [de6ce7] /internal/storage:{dolt,embeddeddolt,issueops}: migrate metadata commands
• [afb6e4] /{cmd,internal}: add test and commit pending
• [e91615] /{cmd,internal}: embeddeddolt list
• [0350e8] /{cmd,internal}: fix commands
• [e04bee] /{cmd,internal}: fix panic
• [5f022d] /{cmd,internal}: implement as of
• [15b619] /{cmd,internal}: implement more methods
• [c36c5f] /{cmd,internal}: maybe create
• [e7a77a] /{cmd,internal}: pr feedback
• [92e25d] /{cmd,internal}: pr feedback
• [a693ac] /{cmd,internal}: pr feedback
• [d6c54c] /{cmd,internal}: refactor again
• [9096e6] /{cmd,internal}: remove unneeded stuff
• [bc286d] /{cmd,internal}: update and close issue methods
• [58915b] /{cmd,internal}: update global store to be interface
• [35d847] Update untrue comment
• [bc4ca1] chore(deps): bump github.com/anthropics/anthropic-sdk-go to v1.27.0 (PR [#2649])
• [e67a05] cmd/bd/list_embedded_test.go: fix test
• [840e42] cmd/bd/list_embedded_test.go: fix text
• [0857ce] cmd/bd: fix list tests
• [3af3ea] fix(cmd/bd): preserve repo config when reopening stores by path (PR [#2628])
• [389f97] perf: cache doctor beads dir resolution (PR [#2643])
• [9e17db] refactor(doltserver): introduce ServerMode enum to consolidate server ownership inference
• [cf8513] refactor: clean up residual sync.mode references (PR [#2661])
• [13a83b] refactor: make BEADS_ACTOR primary env var, BD_ACTOR deprecated fallback (bd-hm9r)
• [5d87e3] refactor: remove GUPP references from beads codebase (bd-5zkx)
• [54dc39] refactor: remove HOP fields from beads schema (bd-vcps)
• [159737] refactor: remove agent role config categories from beads (bd-lvdl)
• [0bd598] refactor: remove agent-as-bead subsystem from beads (bd-4vw2)
• [3dae6b] refactor: remove gastown/Gas Town string references from beads code and docs (bd-1ue8)
• [655dc3] refactor: remove patrol molecule references from beads commands (bd-74p3)
• [8f1830] refactor: remove polecat/crew/gastown GT terminology from beads types (bd-77g2)
• [d6d11c] refactor: remove polecat/crew/overseer GT terminology from beads types (bd-77g2)
• [d8af81] refactor: replace GT_ROLE parsing with BD_ACTOR in hooks (bd-b4q6)
• [e66ee1] style: fix gofmt formatting in doltserver.go
• [0838b0] {cmd,internal}: implement method