beads v0.26.1
Pre-compiled binaries for Linux, macOS (Intel & Apple Silicon), and Windows.
Installation
Homebrew (macOS/Linux):
brew install steveyegge/beads/bdQuick Install (macOS/Linux):
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
- 13b2ab6 feat(doctor): add fresh clone detection check (bd-4ew)
- cd114b7 feat: extract error handling helpers FatalError/WarnError (bd-s0z)
- 39909c1 feat: implement health checks in daemon event loop (bd-gqo)
Bug Fixes
- 1d5fd64 fix(daemon): add cross-process locking to registry (bd-5bj)
- 86d6ffe fix(doctor): exclude merge artifacts from multiple JSONL warning
- 3a48401 fix(init): add safety guard to prevent overwriting existing data
- bb16f24 fix(init): error on invalid JSON instead of overwriting settings (#404)
- 1cb8557 fix(sync): cleanup snapshot files at end of sync (bd-0io)
- 40b86a1 fix(sync): cleanup snapshots after sync regardless of --no-pull (bd-0io)
- 650dcd4 fix(tests): resolve short test performance regression (bd-0v4)
- 80cf1d7 fix: actually restore issues.jsonl (80 issues)
- 8c6e25e fix: clear stale deletions manifest after corruption recovery
- 3f60926 fix: doctor deletions check and onboard docs improvements
- 8becf0d fix: handle multi-hyphen prefixes with hash IDs (#419)
- cb6ccef fix: harden JSONL path handling
- 60034e3 fix: restore beads database after swarm corruption
- 24c301d fix: restore beads database with 12 open issues
Others
- 03fa119 Add close reason display for closed issues
- 95371ea Export and display close reasons for issues (beads-410)
- 774a576 Fix auto-import git history backfill bug (bd-4pv)
- 22d34a2 Fix bd migrate loop: skip prefix validation during auto-import
- bc37afb Fix bd sync staging gitignored files (bd-guc)
- 8b8a662 Fix fresh clone UX with friendly error messages (bd-dmb)
- fe4f851 Fix validatePostImport false positive for legitimate deletions (bd-pg1)
- 1675275 Implement auto-merge functionality for duplicates command
- a7db382 Merge conflict resolution: bd-0io cleanup comment wording
- ef50e80 Resolve merge conflicts in issues.jsonl and main.go
- 7285fc0 Save stashed work as patches (pre-reboot backup)
- e481938 bd sync: 2025-11-27 01:06:58
- ecd5463 bd sync: 2025-11-27 01:25:47
- d59ee64 bd sync: 2025-11-27 01:36:23
- cbf748e bd sync: 2025-11-27 13:02:18
- c196a55 bd sync: 2025-11-27 14:22:28
- 39ed527 bd sync: 2025-11-27 15:18:08
- 3a6a8ab bd sync: 2025-11-27 17:01:20
- 83d1c01 bd sync: 2025-11-27 18:22:06
- cb3dcae bd sync: 2025-11-27 18:49:27
- 76a2542 bd sync: 2025-11-27 20:21:31
- 7447a50 bd sync: 2025-11-27 20:47:47
- 9b6d5a5 bd sync: 2025-11-27 22:34:34
- f06f282 bd sync: 2025-11-27 22:38:26
- 498715f bd sync: 2025-11-27 22:39:17
- 151a34b bd sync: 2025-11-27 22:40:24
- d50861f bd sync: 2025-11-27 22:50:54
- 3c5d1e0 bd sync: 2025-11-27 22:57:13
- 060c2b6 bd sync: 2025-11-27 22:57:28
- 3eced4e bd sync: 2025-11-28
- 2291872 bd sync: 2025-11-28 10:51:09
- 2c6bc58 bd sync: 2025-11-28 17:06:39
- 56df5d4 bd sync: 2025-11-28 17:28:35
- 93d08a2 bd sync: 2025-11-28 17:28:45
- e05c762 bd sync: 2025-11-28 17:28:55
- 7c25cc0 bd sync: 2025-11-28 17:41:56
- e7155d1 bd sync: 2025-11-28 17:42:24
- 6cd9e88 bd sync: 2025-11-28 17:42:51
- b33259a bd sync: 2025-11-28 17:43:02
- 6df2b44 bd sync: 2025-11-28 17:43:30
- 1eb2e1c bd sync: 2025-11-28 18:22:06
- e395b45 bd sync: 2025-11-28 18:22:16
- c0d7f09 bd sync: 2025-11-28 18:36:54
- 4575087 bd sync: 2025-11-28 18:38:41
- 1ec78c0 bd sync: 2025-11-28 18:46:56
- 044e2dd bd sync: 2025-11-28 18:52:00
- 8f71b5f bd sync: 2025-11-28 19:50:16
- 447181e bd sync: 2025-11-28 21:46:03
- 74aac72 bd sync: 2025-11-28 21:46:12
- b5d436c bd sync: 2025-11-28 21:46:21
- 92b7524 bd sync: 2025-11-28 21:46:29
- b97703d bd sync: 2025-11-28 21:49:39
- d4154ca bd sync: 2025-11-28 21:50:01
- efff0c9 bd sync: 2025-11-28 21:50:04
- 271e758 bd sync: 2025-11-28 21:51:56
- 36705eb bd sync: 2025-11-28 21:52:08
- f493ca4 bd sync: 2025-11-28 21:52:23
- e18a753 bd sync: 2025-11-28 21:53:48
- c9d6c43 bd sync: 2025-11-28 21:54:38
- 898d586 bd sync: 2025-11-28 21:54:46
- 61c61d5 bd sync: 2025-11-28 21:56:17
- 284d614 bd sync: 2025-11-28 21:56:19
- 8259546 bd sync: 2025-11-28 21:57:15
- d782574 bd sync: 2025-11-28 21:57:22
- a34c56c bd sync: 2025-11-28 22:14:57
- 675b7a4 bd sync: 2025-11-28 22:14:57
- 69e724f bd sync: 2025-11-28 22:15:45
- b7ed7b3 bd sync: 2025-11-28 22:16:11
- 4ef5a28 bd sync: 2025-11-28 22:17:18
- 52fe608 bd sync: 2025-11-28 23:07:13
- 12b6780 bd sync: 2025-11-28 23:08:01
- 4c713e0 bd sync: 2025-11-28 23:08:12
- 70dc070 bd sync: 2025-11-28 23:08:50
- 116acd4 bd sync: 2025-11-28 23:09:11
- 3ccfc8e bd sync: 2025-11-28 23:09:20
- 5882a2f bd sync: 2025-11-28 23:10:29
- 51db4c8 bd sync: 2025-11-28 23:10:52
- bca8022 bd sync: 2025-11-28 23:13:57
- ce53a43 bd sync: 2025-11-28 23:15:17
- 26f84b6 bd sync: 2025-11-28 23:19:01
- 608eeb8 bd sync: 2025-11-28 23:19:26
- 7a38cb2 bd sync: 2025-11-28 23:25:34
- 2499993 bd sync: 2025-11-28 23:25:41
- ad0babc bd sync: 2025-11-28 23:26:20
- 975da2f bd sync: 2025-11-28 23:26:28
- d672eb0 bd sync: 2025-11-28 23:27:08
- 642f1c2 bd sync: 2025-11-28 23:27:36
- 0ab815d bd sync: 2025-11-28 23:28:10
- 092863b bd sync: 2025-11-28 23:34:12
- 65baeec bd sync: 2025-11-28 23:36:21
- 078efdf bd sync: 2025-11-28 23:37:56
- 559526a bd sync: 2025-11-29 10:07:08
- 69d6754 bd sync: 2025-11-29 13:20:14
- 595b794 bd sync: 2025-11-29 13:20:30
- 1023981 bd sync: 2025-11-29 13:28:39
- 92c1a7e bd sync: 2025-11-29 13:30:51
- 57bb3a7 bd sync: 2025-11-29 13:30:51
- d933caf bd sync: 2025-11-29 13:30:51
- 53aca85 bd sync: 2025-11-29 13:30:53
- 33aa1ea bd sync: 2025-11-29 13:30:57
- d29ab0e bd sync: 2025-11-29 13:30:59
- 189d15d bd sync: 2025-11-29 13:31:00
- cf834d5 bd sync: 2025-11-29 13:31:07
- 54af3a3 bd sync: 2025-11-29 13:31:09
- 83ea1bf bd sync: 2025-11-29 13:31:10
- 614a820 bd sync: 2025-11-29 13:31:16
- 697491d bd sync: 2025-11-29 13:33:06
- b2f6f53 bd sync: 2025-11-29 13:34:57
- bb39c8b bd sync: 2025-11-29 13:35:12
- 9371805 bd sync: 2025-11-29 13:35:28
- 64a5905 bd sync: 2025-11-29 14:25:04
- db9b466 bd sync: 2025-11-29 15:04:32
- 10a7b44 bd sync: 2025-11-29 15:05:34
- 5a0d6db bd sync: 2025-11-29 17:00:25
- edca861 bd sync: apply DB changes after import
- 7fb2122 bd sync: apply DB changes after import
- 01dde64 bd sync: apply DB changes after import
- 9b86e8b bd sync: apply DB changes after import
- d6f19d7 bd sync: apply DB changes after import
- 93b1c47 bd sync: apply DB changes after import
- bba6dd1 bd sync: apply DB changes after import
- f269554 bd sync: apply DB changes after import
- 65e8fa1 bd sync: apply DB changes after import
- 061d11d bd sync: apply DB changes after import
- 6aa0f58 bd sync: apply DB changes after import
- 7b1d291 bd sync: apply DB changes after import
- e96782f bd sync: apply DB changes after import
- 622e16c bd sync: apply DB changes after import
- 4686256 bd-4ew: Doctor detects fresh clone and recommends 'bd init'
- 762252e bd-53c: File P0 bug for bd sync corruption
- 9d896c3 bd-bok: Add --yes/-y flag to bd doctor --fix for non-interactive mode
- 6f9d8d3 bd-c8x: Stop searching parent directories at git root
- 9efd31d bd-o2e: Add --squash flag to bd sync for batching commits
- 30197ee bd-upd: Add snapshot cleanup to daemon sync function
- 9abe99e docs(UX): improve daemon and merge documentation (bd-bt6y)
- a5ec5c6 feat(bd-1pj6): Add custom status states via config
- 340016c fix(bd-53c): Add reverse ZFC check to prevent stale DB from corrupting JSONL
- a4e0f9d fix(no-db): auto-detect JSONL-only mode when config has no-db:true (bd-5kj)
- 40b0704 refactor: deduplicate FindJSONLInDir function (bd-8a5)
- f59f8c2 refactor: rename last_import_hash to jsonl_content_hash (bd-39o)
- eeab5e5 test(doctor): add test for beads.base.jsonl merge artifacts (bd-ov1)