github steveyegge/beads v0.61.0

7 hours ago

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 beads

Quick Install (macOS/Linux/FreeBSD):

curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash

Windows (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

  • 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

Don't miss a new beads release

NewReleases is sending notifications on new releases.