steveyegge/beads v0.37.0 on GitHub

beads v0.37.0

Pre-compiled binaries for Linux, macOS (Intel & Apple Silicon), and Windows.

Installation

Homebrew (macOS/Linux):

brew install steveyegge/beads/bd

Quick Install (macOS/Linux):

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

f3a5e02 feat(close): Add --suggest-next flag to show newly unblocked issues (GH#679)
e91f0de feat(formula): Add inline step expansion (gt-8tmz.35)
e845893 feat(formula): Implement expansion var overrides (gt-8tmz.34)
f82c75c feat(formula): Validate expanded step IDs are unique (gt-8tmz.36)
0718156 feat(gate): Add GitHub gate evaluation (gh:run, gh:pr)
5c3a401 feat(init): Auto-detect fork repos and offer to configure .git/info/exclude (GH#742)
f6c739f feat(merge): Export Merge3WayWithTTL for configurable tombstone TTL (bd-6rl)
2ff1768 feat(prime): add no-git-ops config to disable git ops in session close (GH#593)
516c62e feat: Add aspect composition support (gt-8tmz.5)
09d0532 feat: Add bd formula list/show commands (gt-8tmz.14)
92e99c8 feat: Add bd mol stale command to detect complete-but-unclosed molecules (bd-anv2)
f56f361 feat: Add condition evaluator for gates and loops (gt-8tmz.7)
cb6f3cd feat: Add formula name support to bd mol bond (gt-8tmz.25)
b43358b feat: Add nested loop support in control flow (gt-zn35j)
a42fac8 feat: Add on_complete/for-each runtime expansion types (gt-8tmz.8)
c7bc8e6 feat: Add proto prefix for distilled molecules (bd-hobo)
bce4f8f feat: Add source tracing metadata to cooked steps (gt-8tmz.18)
29501c7 feat: Add stale molecules check to bd doctor (bd-6a5z)
abf6722 feat: Compile-time vs runtime cooking (gt-8tmz.23)
f78fe88 feat: Distinct prefixes for protos, molecules, wisps (bd-hobo)
4f06502 feat: Implement control flow operators (gt-8tmz.4)
b21b318 feat: Improve bd mol distill command
56deb02 feat: Support ephemeral protos: cook inline for pour/wisp/bond (bd-rciw)
35e8c06 feat: add beads-release formula for molecular releases

Bug Fixes

47cc84d fix(docs): standardize sync branch name and daemon syntax (GH#376)
3034fc3 fix(doctor): handle installed_plugins.json v2 format (GH#741)
9a50824 fix(gate): Use correct gh pr field name (mergedAt, not merged)
6d23689 fix(init): guard git.IsWorktree() with isGitRepo() check (GH#727)
488ec56 fix(mcp): Graceful fallback on Windows for daemon mode (GH#387)
7fbc276 fix(multirepo): Preserve gate await fields during upsert (bd-gr4q)
c64ad02 fix(npm): Windows postinstall file locking issue (GH#670)
32c803d fix(worktree): Cache git detection results to eliminate slowness (bd-7di)
3b3f844 fix: Address code review issues in bd mol bond formula support
c9aa755 fix: Address code review issues in condition evaluator
64d2f37 fix: Allow tombstones to retain closed_at timestamp
d2f7177 fix: Chain iterations after nested loop expansion (gt-zn35j)
9c1bf7d fix: Combine db prefix with type prefix for mol/wisp IDs (bd-hobo)
8b5168f fix: Control flow review fixes (gt-8tmz.4)
d2b1656 fix: Make child→parent dep fix opt-in with --fix-child-parent (bd-cuek)
de1a955 fix: Map expansion now matches nested child steps (gt-8tmz.33)
fd57f61 fix: Prevent aspect self-matching infinite recursion (gt-8tmz.16)
2f9d423 fix: Prevent bd sync from committing non-.beads files (bd-trgb)
ec85577 fix: Remove unused code from wisp.go (code review followup)
257ed9b fix: Restore skill files accidentally deleted by bd sync (GH#738)
efdaa93 fix: Use FatalErrorRespectJSON across all commands (bd-28sq)
d9bf695 fix: Use FatalErrorRespectJSON for JSON-consistent error output (bd-28sq.1)
939ade7 fix: doctor check skips interactions.jsonl and molecules.jsonl (GH#709) (#739)
94c3fa2 fix: filter wisps from nodb writeIssuesToJSONL (bd-9avq)
9f8b347 fix: filter wisps from sync_export.go (bd-687g)
c429405 fix: mol run loads all hierarchical children + supports title lookup (bd-c8d5, bd-drcx)
2a6191e fix: use content-level merge for divergence recovery (bd-kpy)

Others

df5d4b3 Add TOML support for formulas (gt-xmyha)
a0e4267 Add bd gate approve command for human gates (gt-twjr5.4)
1d3a7f9 Add bd gate eval command for timer gate evaluation (gt-twjr5.2)
ea9f1d2 Add edge case tests for expression evaluator (code review)
e0403c2 Add mail gate evaluation in bd gate eval (gt-twjr5.4)
258d183 Add waits_for handling to collectDependenciesToSubgraph (gt-8tmz.38)
b82d0e7 Fix expansion operators: update dependencies after expansion
73e56d0 Fix in-place mutation in ApplyBranches/ApplyGates (gt-v1pcg)
acb4aee Fix misleading comment in replaceStep
127a36d Formula cycle detection: show full extends chain in error message (gt-8tmz.15)
a643b9a Implement advice operators for formula composition (gt-8tmz.2)
030838c Implement computed range expansion for loops (gt-8tmz.27)
cfb1196 Implement expansion operators for formula composition (gt-8tmz.3)
ba17898 Implement fanout gate: waits-for children aggregation (gt-8tmz.38)
84c124f Implement max expansion depth limit (default 5) (gt-8tmz.17)
dd0fb7c Remove bd mol run - orchestration belongs in gt
9314f20 Remove hardcoded deacon assignee from gate.go
fd72ce8 bd sync: 2025-12-24 14:39:47
fda4f78 bd sync: 2025-12-24 15:53:49
c065e98 bd sync: 2025-12-24 16:23:00
922e545 bd sync: 2025-12-24 16:25:37
e3a7bf8 bd sync: 2025-12-24 16:30:40
d953cf6 bd sync: 2025-12-24 16:45:30
d3245d2 bd sync: 2025-12-24 16:53:22
6325487 bd sync: 2025-12-24 17:40:20
5eacec4 bd sync: 2025-12-24 18:24:08
4668240 bd sync: 2025-12-24 18:30:11
fbae771 bd sync: 2025-12-24 19:31:04
c3b971e bd sync: 2025-12-24 20:00:04
12bd2e4 bd sync: 2025-12-24 20:07:54
53d905a bd sync: 2025-12-24 20:43:10
3c14ec7 bd sync: 2025-12-24 21:02:59
204e8e6 bd sync: 2025-12-24 21:16:04
358eed7 bd sync: 2025-12-24 21:17:16
ba6f1f5 bd sync: 2025-12-24 21:18:49
a1a4341 bd sync: 2025-12-24 22:41:46
fecbc5b bd sync: 2025-12-24 23:12:58
81171ff bd sync: 2025-12-24 23:32:27
8b6a8cf bd sync: 2025-12-25 00:59:25
8128324 bd sync: 2025-12-25 01:05:06
a8ec1d6 bd sync: 2025-12-25 01:21:15
fca9e54 bd sync: 2025-12-25 01:50:05
9451eec bd sync: 2025-12-25 02:05:15
451c9e4 bd sync: 2025-12-25 11:56:39
2392496 bd sync: 2025-12-25 12:05:37
71dc671 bd sync: 2025-12-25 12:18:21
6311fba bd sync: 2025-12-25 12:18:37
fe66188 bd sync: 2025-12-25 12:31:14
df3a6bf bd sync: 2025-12-25 12:42:51
e7735f0 bd sync: 2025-12-25 13:32:48
6da9610 bd sync: 2025-12-25 13:40:56
e410b9b bd sync: 2025-12-25 13:56:03
76f2179 bd sync: 2025-12-25 14:06:00
788e07b bd sync: 2025-12-25 14:49:21
c1fefc1 bd sync: 2025-12-25 16:55:34
e4feccf bd sync: 2025-12-25 17:03:56
fbd2371 bd sync: 2025-12-25 19:32:24
8050e7b bd sync: 2025-12-25 19:38:08
3e76283 bd sync: 2025-12-25 19:40:08
bbe1980 bd sync: 2025-12-25 19:43:27
46b7f16 bd sync: 2025-12-25 19:55:25
76c1e08 bd sync: 2025-12-25 20:01:13
35ab0d7 bd sync: 2025-12-25 20:01:27
3d83226 bd sync: 2025-12-25 20:20:55
acc7168 bd sync: 2025-12-25 22:04:46
e581188 bd sync: 2025-12-25 22:27:01
e22cdc2 bd sync: 2025-12-25 22:34:55
92e6ccb bd sync: 2025-12-25 22:45:49
1c95ac9 bd sync: 2025-12-25 22:57:05
5788f90 bd sync: 2025-12-25 23:20:35
a975cde bd sync: 2025-12-26 00:57:19
8fa3a21 bd sync: 2025-12-26 00:58:07
cc858b8 bd sync: 2025-12-26 01:10:54
1fdd353 bd sync: 2025-12-26 01:12:48
c366d53 bd sync: Filed bd-70c4 (gate await fields bug)
ae2a0b2 bd sync: merge divergent histories (content-level recovery)
3b0630b chore(formula): Convert beads-release to TOML format
19a182a docs(git): Add thread-safety warning to ResetCaches() (bd-43xj)
4ffbab5 docs(worktrees): Add 'Fully Separate Beads Repository' section (GH#195)
bd5fc21 feat(ready,blocked): Add --parent flag for scoping by epic/bead desce… (#743)
54a051a gt-4v1eo: Implement ephemeral protos - cook formulas inline
e068ac5 refactor: Simplify wisp architecture - badges not separate storage
e6ce0d6 refactor: Switch formula format from YAML to JSON
5a46879 refactor: remove deprecated .beads-wisp directory support (bd-bkul)
f2e6df9 refactor: simplify wisp architecture - single DB with Wisp flag (bd-bkul)
c0271ae wip: simplify wisp architecture - single db with Wisp flag (bd-bkul)