beads v0.44.0
Pre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), and FreeBSD.
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
- 9880eaf feat(config): support daemon.auto_* settings in config.yaml (GH#871)
- 5229b3e feat(dep): add --blocked-by and --depends-on flag aliases (bd-09kt)
- 4462626 feat(dep): add --blocks shorthand flag for natural dependency syntax
- 6202711 feat(dep): add --blocks shorthand flag for natural dependency syntax (GH#884)
- 68f5bb2 feat(doctor): add sync divergence check for JSONL/SQLite/git (GH#885)
- e293131 feat(formula): add gate-aware beads-release.formula v2 (bd-r24e)
- d7246a1 feat(gate): add add-waiter and show commands for phase handoff
- 55d3ac7 feat(gate): add bd gate check command for timer gate evaluation (bd-kbfn)
- 3c5b741 feat(gate): add bd gate check for GitHub gate evaluation (bd-oos3)
- a89f47c feat(gate): add bd gate discover for gh:run await_id auto-discovery (bd-z6kw)
- 3d93166 feat(gate): add cross-rig bead gate support (Phase 4)
- bb0a0ea feat(mol): add compound visualization in bd mol show (bd-iw4z)
- 4021f49 feat(prime): add PRIME.md override for workflow customization (GH#876)
- 6730fce feat(setup): refactor to recipe-based architecture (bd-i3ed)
- 0c7dcee feat(slot): Add merge-slot gate for serialized conflict resolution
- 4468ff0 feat(sync): add BD_DEBUG_SYNC env for protection debugging
- f156e16 feat(template): propagate gate fields through template cloning
- 8fa2729 feat: add /handoff skill for session cycling
- b8f9dab feat: add /handoff slash command for user invocation (bd-xwvo)
- 661556a feat: add multi-prefix support via allowed_prefixes config (#881)
- 44a5c3a feat: detect uncommitted JSONL changes before sync (GH#885, bd-vd8e)
Bug Fixes
- 079b346 fix(agent): add routing support for cross-repo agent resolution (#864)
- a5d9793 fix(agent): support hyphenated rig names in parseAgentIDFields (GH#868)
- e623746 fix(config): normalize keys in GetYamlConfig to match SetYamlConfig (#874)
- 631b067 fix(daemon): normalize paths for case-insensitive filesystem comparison (GH#869)
- b789b99 fix(daemon): normalize paths for case-insensitive filesystems (GH#880)
- 2f96795 fix(daemon): propagate startup failure reason to user (GH#863)
- 426f67d fix(dep): ensure cycle detection runs in daemon mode for --blocks flag
- 28b44ed fix(doctor): detect missing git repo and improve daemon startup message (#890)
- 1a0ad09 fix(doctor): detect status mismatches between DB and JSONL (GH#885)
- 5619dc0 fix(doctor): skip JSONL tracking checks in sync-branch mode (GH#858) (#860)
- a1079fc fix(git): use case-insensitive path comparison for worktree validation (GH#880)
- b3ebedb fix(init): prevent parent hub contamination during bd init (GH#896)
- 563f7e8 fix(merge): preserve close_reason field during merge/sync (GH#891)
- ad44b32 fix(merge): sort output by issue id (#859)
- fc8437e fix(mol): substitute title/desc vars in root molecule bead
- 85ac1e1 fix(nodb): set cmdCtx.StoreActive in initializeNoDbMode (GH#897)
- c848c0f fix(npm): add retry logic for Windows zip extraction
- 053d005 fix(show): display external_ref field in text output (#899)
- 9d69099 fix(slot): add cross-beads prefix routing to bd slot set (bd-hmeb)
- 659f52d fix(sync): avoid double export when uncommitted JSONL detected (bd-uuo9)
- 62e4eaf fix(sync): make snapshot protection timestamp-aware (GH#865)
- c6fe9d7 fix(validation): support hyphenated rig names in agent IDs (GH#854)
- df66ecf fix(worktree): disable sparse checkout on main repo after worktree creation (GH#886)
- f37fe94 fix: auto-create agent bead when bd agent state called on non-existent agent
- c41d3e2 fix: bd ready now shows in_progress issues (#894)
- 7b90678 fix: canonicalize path case on macOS for git worktree operations (GH#880)
- 7df6004 fix: code review improvements for GH#870
- f48ecce fix: correct main repo root detection for submodules (#849)
- ede940b fix: defer SQLite metadata updates until after git commit (GH#885)
- f920903 fix: finalize metadata after commit, not after push (GH#885)
- 6a5c289 fix: hide issues.jsonl from git status when sync.branch configured (GH#870)
- 939f222 fix: pass event/mol/time fields through --rig flag (bd-xwvo)
- b3d64d4 fix: prevent event storm when gitRefsPath is empty (#883)
- fbc93e3 fix: prevent sparse checkout config from leaking to main repo (GH#886)
- 6c4b67f fix: respect sync.remote config in bd sync (GH#872, bd-ypvj)
Others
- 625ac5d Add repository guards to deployment workflows (#877)
- a791991 Update link to install script (#867)
- d416d67 bench(sqlite): add isolated cache rebuild benchmarks (bd-zw72)
- 025142d docs(skill): restructure for progressive disclosure pattern (#857)
- 16af63d fix(rename-prefix): sync JSONL before and after prefix rename (#893)
- 32a4a9e perf: batch external dep checks by project (bd-687v)
- fa5011b refactor(dep): extract warnIfCyclesExist helper to reduce duplication
- 73ed489 refactor(mol): remove redundant guard in showCompoundBondingInfo
- 5379055 test(cook): add gate bead creation tests (bd-4k3c)
- 32aea46 test(sync): add unit tests for gitHasUncommittedBeadsChanges (bd-p7i2)