v0.42.0

beads v0.42.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

• 9cc385d feat: Add --claim flag to bd update for work queue semantics (gt-il2p7)
• b8a5ee1 feat: Add tracks relation type for convoy tracking (bd-3roq)
• 602c59e feat: Enhance bd doctor with force repair and source selection
• cb69f1c feat: Show actor on pinned/status change events (gt-1ydd9)
• b63df91 feat: add 'convoy' issue type with reactive completion (bd-hj0s)
• 4c16895 feat: add 'rm' as alias for 'dep remove' (bd-oehv)
• 26e491d feat: add --town flag to bd activity for aggregated cross-rig feed (bd-dx6e)
• 48dca4e feat: add bd state and bd set-state helper commands (bd-7l67)
• 06c8855 feat: add daemon RPC endpoints for config and mol stale (bd-ag35)
• 5c1cd2b feat: add default limit of 50 to bd list (bd-v5fn, GH#788)
• 2b90f51 feat: add doctor check for issues.jsonl git tracking (GH#796)
• 584608a feat: add llms.txt standard support for AI agent discoverability (#784)
• 7216109 feat: add pager support to bd list (bd-jdz3)
• 1b9c0e1 feat: add prepare-commit-msg hook for agent identity trailers (bd-luso)
• 407e75b feat: add refs field for cross-references with relationship types (bd-irah)
• a874893 feat: add structured labels for agent beads (bd-g7eq)
• 6d292f6 feat: add type: event for operational state changes (bd-ecmd)
• f6f9ef2 feat: auto-detect non-TTY and adjust output (bd-xrwy)
• 34e2548 feat: bd list defaults to non-closed issues with 50 limit (GH#788)
• 7f62ae2 feat: bd mol burn now works on mols, not just wisps (bd-l6yk)
• fb5fd88 feat: integrate migration detection into bd doctor (bd-7l27)

Bug Fixes

• c98f582 fix(doctor): add redirect to .gitignore template for worktree support (#813)
• 38a6097 fix(doctor): wire up CheckRedirectNotTracked and FixRedirectTracking
• 3e453cd fix: Enhance error classification for PRAGMA integrity check failures
• e20de54 fix: MCP plugin follows .beads/redirect files (bd-7t9a, gt-tnw)
• 0f8d709 fix: add missing mockStorage methods for Storage interface compliance
• 160feb9 fix: bd admin compact --older-than=0 now expires all tombstones
• aff3870 fix: bd doctor false positive for molecule/wisp prefix variants
• 6b78b3f fix: bd sync fails to copy local changes TO beads-sync worktree (#810)
• 23dccff fix: bypass external direct-commit when sync.branch is configured (bd-n663)
• cf4aff1 fix: bypass gitHasBeadsChanges when using sync-branch (#812)
• f77b290 fix: git hook chaining now works correctly (GH#816)
• 22fb3ff fix: improve --town mode robustness from code review
• aa759c0 fix: improve jira sync error when Python script not found (GH#803)
• 6d84701 fix: migration 022 fails with SQL syntax error on v0.30.3 upgrade
• 310d374 fix: prevent .beads/redirect from being committed (GH#814)
• 3c6354c fix: prevent label accumulation when updating agent role_type/rig
• 9945126 fix: prevent sync.branch from being set to main/master (#807)
• 7d4e8e2 fix: read operations no longer modify database file (GH#804)
• ebd5c1b fix: rename BondRef.ProtoID to SourceID for clarity (bd-ia3g)
• 2e55f28 fix: show "No changes to commit" when sync-branch worktree has no changes

Others

• a34f189 Add 'last touched' issue tracking for update/close without ID
• b45e68c Add BD_AGENT_MODE for ultra-compact output
• 9158c23 Add bd preflight command with static checklist (Phase 1)
• da550f0 Add close_reason to JSONL format documentation and tests (bd-lxzx)
• 8eccc3d Add debug logging for YAML parse errors in autoimport (bd-mql4)
• 0f21a80 Add debug logging for tombstone resurrection events
• def4cf4 Add sync branch integrity guards for force-push detection (bd-hlsw.4)
• 21a0ff6 Add type: event for state transitions (bd-ecmd)
• 4ab85ee Add unit tests to improve cmd/bd CLI coverage (bd-llfl)
• 643a162 Centralize validation patterns with composable validators (bd-jbqx)
• 6df2d69 Design contributor namespace isolation for beads pollution prevention
• a534764 Document labels-as-state pattern for operational state (bd-31ae)
• b919c47 Exclude agent type from bd ready by default
• a190381 Exclude agent type from bd ready by default
• 952944e Fix BD_ACTOR handling in direct mode paths
• f94e8d4 Fix BD_ACTOR handling in direct mode paths
• 3ed2589 Fix BD_ACTOR handling in direct mode paths
• 8f4af0a Fix bd sync failing to copy local changes to beads-sync worktree (GH#810)
• aa2c66c Implement Jira issue timestamp comparison for sync (bd-0qx5)
• e9f6bfe Improve CLI_REFERENCE epic creation example (#808)
• 430c6bb Merge remote-tracking branch 'origin/fix/actor-on-status-events'
• 9ee4fb5 Refactor TestZFCSkipsExportAfterImport to use direct import logic (bd-h048)
• f91d4fa Refactor: Introduce CommandContext to consolidate global variables (bd-qobn)
• 96f2996 Show actor on status/pinned change events in activity feed
• 087a9dd Show actor on status/pinned change events in activity feed
• 31ee2a6 Use types.Status constants in merge package for type safety
• 1b15ec2 bd sync: 2025-12-29 15:27:19
• a4035b1 bd sync: 2025-12-29 16:40:06
• f312101 bd sync: 2025-12-29 17:02:23
• de239e0 bd sync: 2025-12-29 17:05:12
• 2ca76dc bd sync: 2025-12-29 17:10:34
• f5ec63d bd sync: 2025-12-29 17:49:07
• a6b3779 bd sync: 2025-12-29 17:50:18
• 6e9004b bd sync: 2025-12-29 17:52:01
• a7f34d8 bd sync: 2025-12-29 17:54:03
• fd781ce bd sync: 2025-12-29 18:30:11
• 447fe84 bd sync: 2025-12-29 20:47:42
• 61edfaf bd sync: 2025-12-29 20:49:22
• 35ffeea bd sync: 2025-12-29 21:09:05
• 6b12efb bd sync: 2025-12-29 21:10:00
• 5f5a341 bd sync: 2025-12-29 21:13:11
• 48cca7f bd sync: 2025-12-29 21:16:05
• e5cf9b3 bd sync: 2025-12-29 21:26:41
• 99692b5 bd sync: 2025-12-30 00:00:49
• 99e2058 bd sync: 2025-12-30 00:07:05
• 7f16c9d bd sync: 2025-12-30 00:28:24
• 8f07b61 bd sync: 2025-12-30 00:42:11
• 553544f bd sync: 2025-12-30 00:42:19
• 7f5378b bd sync: 2025-12-30 00:55:05
• 32c295c bd sync: 2025-12-30 10:38:01
• 2974352 bd sync: 2025-12-30 10:38:01
• b5284f7 bd sync: 2025-12-30 15:44:39
• 8916780 bd sync: 2025-12-30 15:44:39
• a51abd2 bd sync: 2025-12-30 15:44:48
• a98ba7d bd sync: 2025-12-30 15:44:48
• 1d6139e bd sync: 2025-12-30 15:47:21
• be46c18 bd sync: 2025-12-30 15:47:21
• 3531653 bd sync: 2025-12-30 15:52:08
• 12a6357 b...

v0.41.0

beads v0.41.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

• 7d1ee6d feat: Add 'hooked' status for GUPP work assignment (bd-s00m)
• c45242a feat: Add --reason flag to bd delete for audit trail
• 6c42b46 feat: Add bd compact --purge-tombstones for dependency-aware cleanup (hq-n19iv)
• bb5c27c feat: Add bd init --from-jsonl for preserving manual cleanups
• 1facf7f feat: Add bd repair command for orphaned foreign key refs (hq-2cchm)
• 67cf9dc feat: Add bd swarm create command (bd-fa1q)
• 77ba8f3 feat: Add bd swarm validate command (bd-nkqx)
• f3dcafc feat: Add mol_type schema field for molecule type classification (bd-oxgi)
• c2c2ef5 feat: Update agent ID validation for canonical naming (gt-zvte2)
• a1ac42a feat: add bd swarm status command (bd-5x0j)
• cd942f1 feat: bd repair - add comments/events orphan detection and --json flag
• b3d6ef6 feat: swarm commands improvements (bd-2ubv)

Bug Fixes

• 0521910 fix: --var flag now allows commas in values (#786)
• 71e2f22 fix: Add nolint comments for gosec/errcheck/unparam warnings
• 64d5f20 fix: Add pre-migration orphan cleanup to avoid chicken-and-egg failure (bd-eko4)
• 24966bd fix: Handle .beads/redirect files and limit verbose output in bd doctor --fix
• 2c57d41 fix: Show warning when config.yaml overrides database config (bd-20j)
• fd5bea7 fix: add illumos/solaris support for disk space check (#798)
• 1256352 fix: bd delete --cascade now recursively deletes dependents (#787)
• 05c8bbe fix: bd doctor falsely reports pre-push hook is not a bd hook (#799)
• a6bba83 fix: bd repair - add transaction, backup, dirty_issues marking
• ef40856 fix: bd repair - consistent JSON error handling for find operations
• 0fa97a4 fix: bd sync fails in bare repo worktrees (#785)
• 53a63f2 fix: edge case in normalizeBeadsRelPath for similar prefixes
• 819208b fix: hq- prefix routing by finding town root for routes.jsonl
• 59bc2cd fix: remove gitignore negations that override fork protection (#796)
• 7ff5481 fix: resolve golangci-lint errors (errcheck, gosec, unparam)
• d3b6855 fix: resolve lint errors blocking CI
• 5ccf12e fix: update perles community tool description (#778)

Others

• 2213fc0 Add --short flag to bd show for compact output
• e5d1e72 Add bd human command for focused help menu
• 135802f Consolidate CLI commands to reduce top-level surface area
• 7ffcfe5 Merge Nux polecat work (bd-9btu, bd-9hc9, bd-lrj8, bd-8zbo)
• f150590 Merge PR #802: test: expand routing and compact coverage
• b2c60e7 bd sync: 2025-12-28 10:59:19
• 5e99b68 bd sync: 2025-12-28 13:52:31
• d70d669 bd sync: 2025-12-28 15:33:10
• 167e9a1 bd sync: 2025-12-28 15:38:09
• 7f950ee bd sync: 2025-12-28 15:42:33
• 09876ff bd sync: 2025-12-28 16:02:46
• 5d540c4 bd sync: 2025-12-28 16:18:10
• 715631b bd sync: 2025-12-28 16:41:33
• 1cdece3 bd sync: 2025-12-28 16:41:41
• b5beedb bd sync: 2025-12-28 18:45:30
• 36ae647 bd sync: 2025-12-28 19:00:28
• 27101a4 bd sync: 2025-12-28 19:04:53
• 2b8d9bc bd sync: 2025-12-28 21:28:27
• 302964b bd sync: 2025-12-28 21:31:23
• 2f6efff bd sync: 2025-12-28 21:34:36
• a93736b bd sync: 2025-12-28 21:35:43
• cb601d6 bd sync: 2025-12-28 21:38:58
• 68ffda0 bd sync: 2025-12-28 21:43:56
• 5bd387c bd sync: 2025-12-28 22:07:05
• aa016c8 bd sync: 2025-12-28 22:14:33
• 8e746ed bd sync: 2025-12-28 22:22:39
• 4a6d942 bd sync: 2025-12-28 22:36:53
• 7f1f906 bd sync: 2025-12-28 23:46:11
• 2960a46 bd sync: 2025-12-28 Close bd-1tkd
• ad443c3 bd sync: 2025-12-28 Close bd-1tkd
• 2e7562e bd sync: 2025-12-28 Close bd-5l59
• f7dd2ea bd sync: 2025-12-28 Close bd-9btu, bd-kkka
• 7b92b42 bd sync: 2025-12-29 12:35:12
• 93cc9df bd sync: 2025-12-29 12:43:14
• bd750b1 bd sync: 2025-12-29 12:48:20
• 75e2afd bd sync: 2025-12-29 12:58:08
• 9e5a548 bd sync: 2025-12-29 12:59:10
• 0183af1 bd sync: 2025-12-29 13:34:01
• 6ee7be5 bd sync: 2025-12-29 13:40:37
• 04da559 bd sync: 2025-12-29 13:45:51
• 31bed17 bd sync: 2025-12-29 13:46:54
• 9eb61f9 bd sync: 2025-12-29 14:03:20
• e652449 bd sync: 2025-12-29 14:04:26
• 40b65b8 bd sync: closed bd-9btu after refactoring cook.go
• dedf5cf bd sync: closed bd-9hc9 after refactoring autoflush.go
• 8ed1209 bd sync: code review round 2 issues
• 3fd4ecc perf: fix N+1 query in swarm status blocked check (bd-7p5l)
• 1bb61c5 refactor: Break up 275-line runCook into focused helpers (bd-8zbo)
• efb56e9 refactor: Break up 280-line flushToJSONLWithState into focused helpers (bd-9hc9)
• 1d4eb6d refactor: Consolidate duplicated step collection functions in cook.go (bd-9btu)
• 5560a42 refactor: Export FollowRedirect and consolidate duplicate implementations
• 96c7cce refactor: Extract IssueDetails to shared type (bd-6dnt)
• 2d92b45 refactor: Extract hashFieldWriter to reduce ComputeContentHash repetition (bd-1tkd)
• 934196e refactor: Extract shared importFromJSONLData function
• f459f8e refactor: Extract stepTypeToIssueType helper to remove duplicated switch (bd-j3dj)
• ff264c2 refactor: Organize Issue struct with section comments (bd-5l59)
• d4c5563 refactor: Remove deprecated fetchAndRebaseInWorktree (bd-kkka)
• e6ff1e8 refactor: Remove deprecated fetchAndRebaseInWorktree (bd-kkka)
• 7ea7aee refactor: Split init.go from 1928 to 705 lines (bd-xtf5)
• 6c14fd2 refactor: Split large cmd/bd files to meet 800-line limit (bd-xtf5)
• 7a3498f refactor: extract shared getEpicChildren helper for swarm commands

v0.40.0

beads v0.40.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

• 46cdf07 feat: add agent ID pattern validation for bd create --type=agent (gt-hlaaf)
• 947b5ee feat: add bd agent state command for ZFC-compliant state reporting (bd-uxlb)
• f3c663d feat: add bd doctor --deep for full graph integrity validation (bd-cwpl)
• ecff74e feat: add bd slot commands for agent bead slot management (gt-h5sza)
• f631299 feat: add bd worktree command for parallel development
• 30c5e00 feat: add computed .parent field to JSON output for convenience (bd-qket)
• dfc7965 feat: add pour warning for vapor-phase formulas, improve help text, add doctor check
• ad39aae feat: auto-bypass daemon for wisp operations (bd-ta4r)

Bug Fixes

• d686f0e fix: add --allow-staged flag to bump-version.sh for pre-staged release notes (bd-n97g)
• b5ab4f2 fix: address code review issues in bd worktree command
• 9e7ccb3 fix: update jsonl_file_hash on import to prevent hash mismatch warnings (bd-0vtq)

Others

• b5c6950 Add agent-specific fields to bead schema (gt-v2gkv)
• 927e837 Add type=agent and type=role to bead schema (gt-ikyo1, gt-gzp2y)
• d8ef771 Improve activity feed with title and assignee context
• 6f00e48 Release v0.40.0
• dccbb45 Update references to WORKFLOWS.md in SKILL.md
• b1859f5 bd sync: 2025-12-27 23:24:32
• ac2a2e9 consolidate community tools into dedicated docs page
• 3342dc2 perf(sqlite): replace O(2^n) cycle detection with O(V+E) DFS

v0.39.1

beads v0.39.1

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

• aa3c4cb feat: add 'bd where' command to show active beads location (bd-8x43)
• 35f8e19 feat: add --parent flag to bd update for reparenting issues (bd-cj2e)
• ba1c9d6 feat: show redirect info in bd prime output (bd-kblo)

Bug Fixes

• f9bbe8e fix(doctor): follow redirect when checking database (bd-tvus)
• a737223 fix: doctor checks follow redirect for Gas Town support (bd-tvus)
• ab3feda fix: remove arbitrary 8-char prefix limit from rename-prefix (GH#770)

Others

• aa4da74 Add opencode-beads to Community Tools section of README (#771)
• fee0ce6 bd sync: 2025-12-27 19:56:26
• a1a3626 bd sync: 2025-12-27 20:19:21
• ac837bc bd sync: 2025-12-27 20:41:47
• a326df9 bd sync: 2025-12-27 20:42:09
• bcc611b bd sync: 2025-12-27 21:27:50
• e72eb41 bd sync: 2025-12-27 21:33:33
• 7cd4a96 bd sync: 2025-12-27 21:33:54
• e1de095 bd sync: 2025-12-27 21:44:52
• 59fa2d8 bd sync: 2025-12-27 21:49:38
• cd618f4 bd sync: 2025-12-27 22:17:10
• 05d4450 bd sync: 2025-12-27 22:17:12
• aa99235 refactor: consolidate git context into single cached struct (bd-qph3)

v0.39.0

beads v0.39.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

• 99f5e50 feat: Add 'bd orphans' command with DRY refactoring of orphan detection
• 2e7b993 feat: add --prefix flag for cross-rig issue creation
• d77a697 feat: add bd admin parent command for cleanup/compact/reset (bd-3u8m)
• 2c82acd feat: integrate detect-pollution into bd doctor --check=pollution (bd-kff0)

Bug Fixes

• 2f3877a fix: add macOS codesigning to bump-version.sh --install
• d3fe6b0 fix: lint errors and update Nix vendorHash

Others

• a9d082e bd sync: 2025-12-27 01:09:55
• cd9f810 bd sync: 2025-12-27 14:33:59
• 87f535a bd sync: 2025-12-27 14:48:16
• c8b912c bd sync: 2025-12-27 15:56:42
• 4a993d4 bd sync: 2025-12-27 19:14:17
• 5e99aba bd sync: 2025-12-27 19:18:26
• 2810cf0 refactor: relocate thanks command to bd info --thanks (bd-wb9g)
• 26785f9 refactor: remove bd mol catalog in favor of bd formula list (bd-ctmg)
• 1611f16 refactor: remove unused bd pin/unpin/hook commands (bd-x0zl)

v0.38.0

beads v0.38.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

• 252de1c feat(daemon): add sync backoff and consolidate hints into tips
• 721ae70 feat(doctor): add database corruption recovery to --fix
• c3ef1c3 feat: Add created_by field to issues (GH#748)
• 1583c57 feat: Add prefix-based routing with routes.jsonl (bd-9gvf)
• ea8ae11 feat: Rename 'wisp' to 'ephemeral' in beads API (bd-o18s)
• 21f307d feat: add --rig flag for cross-rig issue creation (bd-4nzq)
• 08cf4d4 feat: add --run-chaos-tests flag to release script (bd-kx1j)
• dae8a7a feat: add comments display to bd show command (#177)
• daf5393 feat: add town-level activity signal for Gas Town daemon (bd-v8ku)
• a958c83 feat: auto-resolve cross-rig IDs in bd dep add (bd-lfiu)

Bug Fixes

• 5c8d45a fix(deps): Mark BurntSushi/toml as direct dependency (GH#749)
• d3e9022 fix(doctor): Preserve parent-child dependencies in child→parent check (GH#750)
• 0575ca9 fix(nodb): set storeActive when initializing no-db mode
• 9c9f2f2 fix(tests): use --initial-branch=main for modern git compatibility
• a923774 fix: Bypass daemon for routed IDs in show command (bd-uu8p)
• 89be2a9 fix: add idempotency check to migration 028 (tombstone_closed_at)
• f6eeb17 fix: add missing CreatedBy in RPC path
• d623488 fix: add missing created_by column to migration 028 (GH#757)
• 78b8134 fix: bd graph works with daemon running (GH#751)
• 05b84c3 fix: bd ready excludes ephemeral (wisp) issues (hq-t15s)
• 9ec8fdd fix: close routed storage connections per iteration in show command
• 0a14abc fix: migration 028 handles missing created_by column
• 350a78f fix: resolve all golangci-lint errors
• a642c5b fix: restore --resolution alias for bd close (GH#746)

Others

• dc89030 Add chaos testing PR #752 review (bd-kx1j)
• 4362758 Fix comments display: move outside dependents block, merge main
• 05304e3 Merge origin/main, fix test git init for modern git
• bf2f200 Move pour and ephemeral under bd mol subcommand (bd-2fs7)
• cc7d2ae Rename bd mol ephemeral back to bd mol wisp
• 15cfef0 Update documentation for bd mol pour/wisp command structure
• b71c06e bd sync: 2025-12-26 12:45:39
• f86a518 bd sync: 2025-12-26 13:34:29
• b9b2c82 bd sync: 2025-12-26 14:36:25
• f11ad08 bd sync: 2025-12-26 14:36:48
• 2a1c03a bd sync: 2025-12-26 14:54:51
• 9bc98cd bd sync: 2025-12-26 15:20:26
• 3b8e4db bd sync: 2025-12-26 17:25:21
• 7046e90 bd sync: 2025-12-26 17:29:25
• 88e76ec bd sync: 2025-12-26 17:38:21
• aba2ee0 bd sync: 2025-12-26 19:28:54
• 3bd60b6 bd sync: 2025-12-26 20:20:46
• e6dc1d7 bd sync: 2025-12-26 20:51:56
• 561bd9a bd sync: 2025-12-26 23:19:26
• 27a82bf bd sync: 2025-12-26 23:38:55
• a84c7a4 bd sync: 2025-12-26 23:41:01
• 3d6fde9 bd sync: 2025-12-26 23:47:52
• 7de1922 bd sync: 2025-12-27 00:34:21
• 6862f6e chore(nix): Update version to 0.37.0 in default.nix (GH#749)
• f5ef444 cmd/bd: add unit coverage for show/update/close
• 8166207 doctor: add JSONL integrity check/fix and harden repairs
• 7af3106 doctor: add fs fault injection and lock contention coverage
• 1184bd1 doctor: add git hygiene checks and DB integrity auto-fix
• 1a4f06e doctor: harden corruption repair and JSONL config
• 59413ba sqlite: stop migrations clobbering pinned/template
• b089aaa tests: add chaos doctor repair coverage and stabilize git init

v0.37.0

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

v0.36.0

beads v0.36.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

• 36feb15 feat(compact): Add --prune mode for standalone tombstone pruning (bd-c7y5)
• cdbca65 feat(config): add override notification for config parameters (#731)
• ce2b053 feat(deps): detect/prevent child→parent dependency anti-pattern (bd-nim5)
• 297c696 feat(doctor): add count-based database size check (#724)
• bed89fd feat(export): add --priority exact match filter (bd-au0.6)
• 4fdcda4 feat(formula): add formula parser and bd cook command (bd-weu8, bd-wa2l)
• f28785d feat(formula): support needs and waits_for fields, add --prefix flag
• 61daa59 feat(list): add --pretty and --watch flags for built-in viewer (#729)
• f777093 feat(rpc): add GetMoleculeProgress endpoint (bd-0oqz)
• 3a82ce2 feat(rpc): add GetWorkerStatus RPC endpoint (bd-l13p)
• 3405f0c feat(rpc): enrich MutationEvent with Title and Assignee fields
• 0d66aed feat(types): add omitempty to JSONL fields for smaller output
• cfd412b feat: add --publish-npm and --publish-pypi flags to bump-version.sh
• c4ce191 feat: add --resolution as alias for --reason on bd close (GH#721)
• 3c786f2 feat: add Windows code signing infrastructure (bd-14v0)
• 7fd4c86 feat: add date, priority, and content filters to bd search (bd-au0.5)
• 47b86b3 feat: add gate issue type and CLI commands for async coordination (bd-udsi)
• ac1f580 feat: enhance natural language activation + Anthropic 2025 compliance (#718)

Bug Fixes

• 48b96c9 fix(config): normalize yaml config keys to canonical format (#732)
• d1c4526 fix(formula): address code review findings
• 9743b45 fix(import): preserve comment created_at timestamps during import (#735)
• f250608 fix(json): audit and standardize JSON output across commands (bd-au0.7)
• 422ec71 fix(json): standardize JSON output for errors and empty arrays (bd-au0.7)
• 42c23e2 fix(lint): add nosec directive for formula parser file read
• ee3d070 fix(mol): respect --pour flag in bond operations (bd-l7y3)
• c28defb fix(sqlite): handle dots in prefix for extractParentChain (GH#664)
• 1e7c7f5 fix(sqlite): update child_counters when explicit child IDs are created (GH#728)
• 37ec967 fix(stealth): use .git/info/exclude instead of global gitignore (GH#704)
• 7f8f8f6 fix(sync): respect sync.remote config in daemon sync operations (#736)
• fe2ac97 fix: Exclude workflow types from bd ready by default (gt-7xtn)
• dcee07f fix: add output_schema=None to MCP tools for Claude Code compatibility (bd-49kw)
• 8676c41 fix: address CI lint errors (gosec, errcheck, unparam, duplicate tests) (#730)
• f2db0a1 fix: exclude external deps from orphan check in migration invariants (bd-ucgz)
• 3d924f8 fix: handle multi-hyphen prefixes correctly (GH#422)
• 0d31e42 fix: preserve pinned field during JSONL import (bd-phtv)
• 2540218 fix: respect allowed_prefixes config during import (gt-2z6s)
• e0f1d43 fix: write startup config keys to config.yaml instead of SQLite (GH#536)

Others

• 05e10b6 Add comprehensive RPC test coverage (44.7% → 61.7%)
• c46b1a0 Add config-based close hooks (bd-g4b4)
• a129e36 Add daemon RPC support for gate commands (bd-likt)
• 2069f0a Add tests for cmd/bd CLI to improve coverage (bd-llfl)
• 7d3447b Add tests for createTombstone and deleteIssue wrappers (bd-d28c)
• 091b4b8 Add tests for setup package (28.4% → 53.8% coverage)
• a768024 Close bd-9usz: Test suite no longer hangs
• e432fcc Enhance Claude Code skill with README and new reference files (#722)
• 143f5c8 Fix TestMain to find module root before building bd binary
• bbb08d6 Fix template commands failing with daemon mode (bd-indn)
• 8118199 Improve bd doctor output formatting for readability (bd-4qfb)
• ffa5de3 Improve internal/beads test coverage from 48% to 80%
• f437ce2 Improve internal/daemon test coverage from 27.3% to 72.0% (bd-n386)
• 05f37d2 Introduce slog for structured daemon logging (bd-u2sc.4)
• 2d592a8 Merge polecat/testcat - tests for delete wrappers (bd-d28c)
• 9354dbd Refactor duplicate JSONL-from-git parsing code (bd-y2v)
• ec0c710 Split queries.go into focused modules (bd-rgyd)
• 2b26de0 Split sync.go into modular files (bd-u2sc.3)
• 03b12e4 Standardize error handling: use FatalError in compact.go, sync.go, migrate.go
• 235dc57 Update Session End Checklist to use gt handoff (gt-yt6g)
• 7e7e0fb Update Session End Checklist to use gt handoff (gt-yt6g)
• 7c4b069 bd close bd-ykd9: doctor --fix feature already implemented
• 2ac190f bd mol run: add cross-database spawning support (gt-jsup)
• 1b9660c bd sync: 2025-12-23 (bd-g4b4 closed)
• a94f956 bd sync: 2025-12-23 00:25:43
• 18d9848 bd sync: 2025-12-23 11:39:18
• 87f1637 bd sync: 2025-12-23 12:06:48
• 5b56c07 bd sync: 2025-12-23 12:13:41
• ceb8ba0 bd sync: 2025-12-23 12:19:49
• 7f2d4af bd sync: 2025-12-23 12:24:08
• dc4423b bd sync: 2025-12-23 12:24:43
• 5f15dc4 bd sync: 2025-12-23 12:27:35
• ad7473d bd sync: 2025-12-23 12:36:33
• 77ff828 bd sync: 2025-12-23 12:40:03
• 1951fae bd sync: 2025-12-23 12:42:18
• f502f95 bd sync: 2025-12-23 12:44:13
• 8e2473c bd sync: 2025-12-23 13:03:01
• 2975d22 bd sync: 2025-12-23 13:03:25
• 624e7de bd sync: 2025-12-23 13:03:48
• 6da4d48 bd sync: 2025-12-23 13:04:11
• b354b4b bd sync: 2025-12-23 13:04:35
• 8f8994c bd sync: 2025-12-23 13:04:59
• 6077c27 bd sync: 2025-12-23 13:05:25
• 9591143 bd sync: 2025-12-23 13:05:48
• c424291 bd sync: 2025-12-23 13:06:12
• 2f7570f bd sync: 2025-12-23 13:06:35
• b172fa7 bd sync: 2025-12-23 13:06:59
• 6cf998e bd sync: 2025-12-23 13:07:22
• bc169a7 bd sync: 2025-12-23 13:07:47
• 68e3de9 bd sync: 2025-12-23 13:10:23
• 3053758 bd sync: 2025-12-23 13:36:29
• d834e4f bd sync: 2025-12-23 13:46:12
• 7b67166 bd sync: 2025-12-23 13:49:07
• f4acf5c bd sync: 2025-12-23 14:18:09
• 649a48d bd sync: 2025-12-23 14:41:28
• a23271d bd sync: 2025-12-23 15:15:28
• 4c9eb70 bd sync: 2025-12-23 15:25:28
• 4bcf2a9 bd sync: 2025-12-23 16:29:02
• be06a68 bd sync: 2025-12-23 16:32:00
• 37042a8 bd sync: 2025-12-23 16:32:21
• c2d6b13 bd sync: 2025-12-23 16:32:42
• d33bd82 bd sync: 2025-12-23 17:03:27
• b889aa6 bd sync: 2025-12-23 18:16:31
• c4473ea bd sync: 2025-12-23 19:12:19
• 1db506f bd sync: 2025-12-23 ...

v0.35.0

beads v0.35.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

• 03f5afb feat(daemon): add auto_pull config parameter for periodic remote sync
• dd9fcd9 feat(scripts): add --all, --mcp-local, --restart-daemons flags to bump-version.sh
• 62bbae9 feat(types): add HOP entity tracking types (bd-7pwh)
• 14e1f5a feat: add --parent flag to bd list command (bd-yqhh)
• be520d9 feat: add bd activity command for real-time state feed (bd-xo1o.3)
• ee04b1e feat: add dynamic molecule bonding with --ref flag (bd-xo1o.1)
• 808c33b feat: add molecule navigation commands (bd-sal9, bd-ieyy)
• 37fd1ce feat: add parallel step detection for molecules (bd-xo1o.4)
• f795f61 feat: add performance optimization indexes (bd-bha9, bd-a9y3, bd-jke6, bd-8x3w, bd-lk39)
• fa9a88e feat: add waits-for dependency type for fanout gates (bd-xo1o.2)
• aa1ce63 feat: consolidate maintenance commands into bd doctor --fix (bd-bqcc)
• ad02b80 feat: display external deps in bd dep tree (bd-vks2, bd-mv6h, bd-d9mu)
• 7fb92ff feat: implement conditional bond type for mol bond (bd-kzda)

Bug Fixes

• 737e65a fix(daemon): add periodic remote sync to event-driven mode (#698)
• 1950917 fix(daemon): deduplicate file and git ref change log messages
• ee016bb fix(daemon): handle diverged sync branch with fetch-rebase-retry on push (#697)
• 82cbd98 fix(daemon): include tombstones in exportToJSONLWithStore for sync propagation (#696)
• e8d0860 fix(doctor): use --fix instead of manual commands (#715)
• e2ab727 fix(doctor): use context.Background() instead of nil in CheckDuplicateIssues
• 665e5b3 fix(worktree): integrate health check into CreateBeadsWorktree to prevent redundant checks
• 7ad9fb5 fix: add interactions.jsonl to .gitignore allowlist
• 117bdd6 fix: add nolint:misspell for SQL query with British spelling
• bd6fa5c fix: bd create -f now works with daemon mode (GH#719)
• da80906 fix: emit rich mutation events for status changes (bd-313v)
• 340417f fix: filter satisfied external deps from GetBlockedIssues (bd-396j)
• e79558a fix: make database_removal_scenario test more realistic
• d677554 fix: prevent parallel execution migration race conditions (GH#720)
• e360a74 fix: resolve all golangci-lint errors (#699)
• 8b49d8f fix: resolve golangci-lint errors
• 9480041 fix: skip interactions.jsonl in FindJSONLInDir (GH#709)

Others

• 6a2909c Add Claude Code settings for zoey crew worker
• bbe1203 bd sync: 2025-12-22 12:10:56
• d578eb8 bd sync: 2025-12-22 12:17:24
• 512cbc0 bd sync: 2025-12-22 12:32:30
• dca5292 bd sync: 2025-12-22 13:13:48
• 8d697a2 bd sync: 2025-12-22 14:53:43
• 07e941a bd sync: 2025-12-22 15:40:07
• 3f3bc32 bd sync: 2025-12-22 15:48:42
• 014efbb bd sync: 2025-12-22 16:02:19
• 8097cd6 bd sync: 2025-12-22 17:04:03
• 11dd84a bd sync: 2025-12-22 17:36:38
• 36c652d bd sync: 2025-12-22 20:09:31
• 0c4e17c bd sync: 2025-12-22 21:15:48
• 607e04c bd sync: 2025-12-22 21:30:29
• 266719c bd sync: 2025-12-22 21:49:02
• 73b2e14 bd sync: 2025-12-22 22:33:34
• c6888c5 bd sync: 2025-12-22 22:59:43
• 8677e5a bd sync: 2025-12-22 23:15:36
• 22ef563 bd sync: 2025-12-23 00:12:38
• ecadb83 bd sync: 2025-12-23 00:12:57
• 97c2c48 bd sync: 2025-12-23 00:13:18
• 2a2142a bd sync: 2025-12-23 00:55:12
• 4bef1fd bd sync: 2025-12-23 01:24:24
• 6f2d160 bd sync: 2025-12-23 01:26:59
• 6188045 bd sync: 2025-12-23 01:33:42
• b2d3577 bd sync: 2025-12-23 01:39:41
• 4a91acb bd sync: 2025-12-23 01:42:22
• da15363 bd sync: 2025-12-23 01:56:10
• a441559 bd sync: 2025-12-23 01:58:29
• a3e967b bd sync: 2025-12-23 02:10:31
• 625d5fb bd sync: 2025-12-23 02:38:39
• 47339f8 bd sync: 2025-12-23 03:18:57
• ac07b22 bd sync: 2025-12-23 03:22:14
• 3c86144 bd sync: 2025-12-23 03:38:21
• ce85fd4 bd sync: 2025-12-23 03:48:52
• 72c1c43 bd sync: 2025-12-23 03:56:58
• 9057351 bd sync: 2025-12-23 04:00:13
• 09e5104 bd sync: 2025-12-23 04:01:07
• 0bc421f bd sync: 2025-12-23 04:16:32
• 41aedac bd sync: 2025-12-23 04:20:56
• 356fda3 bd sync: 2025-12-23 04:33:43
• bea8830 bd sync: 2025-12-23 04:35:03
• b295768 bd sync: 2025-12-23 04:35:08
• cc227db bd sync: 2025-12-23 04:43:29
• 5e4a300 bd sync: 2025-12-23 04:44:17
• ee4750f bd sync: 2025-12-23 04:45:01
• ee1dc98 bd sync: 2025-12-23 04:45:33
• 064e922 bd sync: 2025-12-23 04:46:23
• a097886 bd sync: 2025-12-23 04:47:20
• f66f246 bd sync: 2025-12-23 04:48:32
• 90edbc4 bd sync: 2025-12-23 04:49:14
• 0c14054 bd sync: 2025-12-23 04:49:44
• 379f80d bd sync: 2025-12-23 04:58:04
• 8a78897 chore(deps): bump github.com/ncruces/go-sqlite3 from 0.30.3 to 0.30.4 (#703)
• 0a527e6 chore(deps): bump github.com/tetratelabs/wazero from 1.10.1 to 1.11.0 (#702)
• 6cc8926 chore(nix): update vendorHash for go-sqlite3 0.30.4 and wazero 1.11.0
• ca348a2 docs(daemon): update event-driven mode documentation
• 7f5fa23 fixed an install script bug
• e67712d refactor(cmd): migrate sort.Slice to slices.SortFunc (bd-u2sc.2)
• 4c38075 refactor(cmd): replace map[string]interface{} with typed JSON response structs (bd-u2sc.1)
• cafc0b9 refactor(doctor): consolidate maintenance commands + improve daemon startup
• cfe823d refactor: add testEnv helpers, reduce SQLite test file sizes (bd-4opy)
• fc0b987 refactor: consolidate duplicate path-finding utilities (bd-74w1, bd-4nqq)
• 92e6f4c refactor: remove legacy autoflush code paths (bd-xsl9)

v0.34.0

beads v0.34.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

• 1e096a3 feat: add 'fart' as easter egg alias for bd mol bond
• 22eee81 feat: add --ephemeral flag to bd mol bond (bd-kwjh.3)
• 240a4e2 feat: add bd doctor check for orphaned issues (bd-5hrq)
• 9afefe7 feat: add bd ship command for cross-project capabilities (bd-eijl)
• e7f0966 feat: add cross-project dependency support - config and external: prefix (bd-66w1, bd-om4a)
• 6991107 feat: add cross-store wisp→digest squash (bd-kwjh.4)
• 2d719b1 feat: add ephemeral storage backend for wisps (bd-kwjh.2)
• f27b1f3 feat: add wisp commands (bd-kwjh)
• 1cfb234 feat: bd ready filters by external dep satisfaction (bd-zmmy)
• cadf798 feat: implement molecular chemistry UX commands

Bug Fixes

• a11b209 fix(doctor): UX improvements for diagnostics and daemon (#687)
• 95b735c fix: add third change to satisfy versionChanges test
• 8f8e951 fix: bd repo commands write to YAML and cleanup on remove (#683)
• 2c5acc9 fix: handle empty config values in getRepoConfig() (#684)
• d39e868 fix: handle empty config values in getRepoConfig() (GH#680)
• fe6fec4 fix: remove slice bounds panic in mol run output (bd-987a)
• 6a949d9 fix: rename customID to customTitle in mol bond for consistency (bd-e7ou)
• 9d30e80 fix: skip prefix validation in multi-repo mode (GH#686) (#688)

Others

• 025045b Add DeepWiki badge to README (#689)
• 39750ba bd sync: 2025-12-21 16:15:25
• f56540e bd sync: 2025-12-21 17:20:07
• d06401d bd sync: 2025-12-21 17:28:08
• 6b339e7 bd sync: 2025-12-21 18:02:24
• 310e86d bd sync: 2025-12-21 21:00:10
• c73bf8b bd sync: 2025-12-21 21:14:14
• d554a11 bd sync: 2025-12-21 21:18:55
• 61d70cd bd sync: 2025-12-21 22:04:42
• abb4a84 bd sync: 2025-12-21 22:41:15
• 91b4857 bd sync: 2025-12-21 22:57:55
• 4f2bd88 bd sync: 2025-12-21 23:13:50
• b7c4ba0 bd sync: 2025-12-21 23:41:49
• b3da7b4 bd sync: 2025-12-21 23:42:29
• 5fb254f bd sync: 2025-12-21 23:45:42
• 468751d bd sync: 2025-12-22 00:02:25
• e952219 bd sync: 2025-12-22 00:05:28
• cd2cee9 bd sync: 2025-12-22 00:08:34
• a111b2d bd sync: 2025-12-22 00:13:58
• 7f0a598 bd sync: 2025-12-22 00:18:00
• 065dd23 bd sync: 2025-12-22 00:32:37
• 1d3c9e6 bd sync: 2025-12-22 00:54:24
• b871570 bd sync: 2025-12-22 01:13:15
• 11f3acd bd sync: 2025-12-22 02:22:48
• 9102cdb bd sync: 2025-12-22 02:55:55
• a49b924 refactor: rename ephemeral → wisp throughout (bd-ldb0)
• 199def9 release: v0.34.0
• a9bfce7 wip: external dep resolution helper (bd-zmmy)