beads v0.42.0
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
- 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 bd sync: 2025-12-30 15:52:08
- a0dda7d bd sync: 2025-12-30 15:52:08
- d2cd19a bd sync: 2025-12-30 15:54:09
- 5167dcd bd sync: 2025-12-30 15:54:09
- c904487 bd sync: 2025-12-30 15:54:09
- ece899e bd sync: 2025-12-30 15:56:45
- 9ed15c2 bd sync: 2025-12-30 15:56:45
- d40a08b bd sync: 2025-12-30 15:56:45
- 84a7cea bd sync: 2025-12-30 15:59:32
- 288334f bd sync: 2025-12-30 16:02:24
- 4763973 bd sync: 2025-12-30 16:10:24
- e39dc88 bd sync: 2025-12-30 16:10:24
- 3df87e4 bd sync: 2025-12-30 16:10:24
- f35b37a bd sync: 2025-12-30 16:45:58
- eda74e6 bd sync: 2025-12-30 16:45:58
- eae4e9f bd sync: 2025-12-30 16:45:58
- 7bdad60 bd sync: 2025-12-30 16:47:00
- bd62686 bd sync: 2025-12-30 16:47:43
- 902670d bd sync: 2025-12-30 16:50:04
- ec46829 bd sync: 2025-12-30 17:00:00
- 24f3afc bd sync: 2025-12-30 17:01:07
- 28fa733 bd sync: 2025-12-30 18:11:14
- 1438861 bd sync: 2025-12-30 18:11:22
- b95814c bd sync: 2025-12-30 18:12:00
- 6c02aa3 bd sync: 2025-12-30 21:05:34
- c67dd31 bd sync: 2025-12-30 21:21:09
- 0597d66 bd sync: close bd-7t9a (MCP redirect fix)
- eefeb1a refactor: dedupe error classification, fix --force+--source=db conflict
- 5f3cb0f refactor: remove Gas Town references from codebase
- 7f95ba7 revert: restore original CLAUDE.md (remove Gas Town content leak)