steveyegge/beads v0.24.0 on GitHub

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

e1c8853 feat: Add .beads/README.md generation during bd init (bd-m7ge)
f7e80dd feat: add context optimization features for AI agents (#297)

Bug Fixes

04a1996 fix: Fix daemon export leaving JSONL newer than database (issues #301, #321)
92f3af5 fix: Improve missing git hook message (#306)
57b6ea6 fix: add external_ref support to daemon mode RPC (fixes #303) (#304)
23fce6e fix: add version marker to post-checkout hook and include in CheckGitHooks
fb65163 fix: address critical resource leaks and error handling issues (#327)
4432af0 fix: improve ResolvePartialID / ResolveID handling for bd show (issue #336)
408244e fix: isHashID matches for hyphenated application names
68f9bef fix: prevent daemon from exiting when launcher process exits (issue #278)
6a25f5e fix: resolve remaining hyphenated ID issues in memory store and doctor

Others

e8355c2 Add 'bd clean' command to remove temporary merge artifacts
7a187cb Add .envrc to .gitignore
8f37904 Add auto-detection of issue prefix from git history (#277)
7806937 Add bd doctor --fix flag to automatically repair issues (bd-ykd9)
b2c50bc Add bd-khnb: Critical bug in auto-import resurrects deleted issues
62c1f42 Add blocked_issues_cache table for GetReadyWork optimization
614ba8a Add cache invalidation for blocked_issues_cache
7c96142 Add commit hash to bd version output (bd-hpt5)
0916abf Add debug logging to bd merge for troubleshooting
a42e84c Add issues bd-gdn, bd-5xt, bd-i00 for future improvements
a020c6c Add uv prerequisite to Claude Code plugin documentation (#293)
f20aec6 Add warning that MCP Agent Mail is not configured
bf9b2c8 Annotate gosec-safe file accesses
fc7b462 Bump fastmcp from 2.13.0.2 to 2.13.1 in /integrations/beads-mcp (#332)
48cd52b Bump github.com/anthropics/anthropic-sdk-go from 1.16.0 to 1.17.0 (#289)
ff90be7 Bump github.com/anthropics/anthropic-sdk-go from 1.17.0 to 1.18.0 (#330)
6ea546b Bump github.com/google/go-cmp from 0.6.0 to 0.7.0 (#291)
ff9642d Bump github.com/ncruces/go-sqlite3 from 0.29.1 to 0.30.1 (#290)
aeea353 Bump golang.org/x/mod from 0.29.0 to 0.30.0 (#331)
1c6a652 Bump golang.org/x/sys from 0.36.0 to 0.38.0 (#288)
f674b88 Bump golangci/golangci-lint-action from 8 to 9 (#287)
fee6ef2 Bump pydantic from 2.12.0 to 2.12.4 in /integrations/beads-mcp (#285)
82f9d67 Bump pydantic-settings from 2.11.0 to 2.12.0 in /integrations/beads-mcp (#286)
3b2cac4 Centralize error handling patterns in storage layer (bd-bwk2)
cafcc55 Clean up beads-mcp .gitignore
88210fe Clean up spurious and duplicate issues
4f481c8 Close bd-5qim (GetReadyWork optimization completed in 690c73f)
109b9d2 Close bd-g9eu (TestRoutingIntegration investigation)
e28e3ea Close bd-khnb: Auto-import resurrection bug fixed
57253f9 Context propagation with graceful cancellation (bd-rtp, bd-yb8, bd-2o2)
62e39d0 Delete 490 closed beads to streamline database
06d655a Delete 490 closed issues to streamline database
7b6370f Delete 497 closed beads (resurrection bug cleanup)
79b8dbe Document MCP tools loading issue in Claude Code (issue #346)
e7fd1dd Document files created by bd init and clarify .gitattributes should be committed
721274b Document which files to commit after bd init --branch
f013268 Enhance bd doctor with bd prime migration recommendations (bd-0fvq)
b49f9b7 File bd-77gm: Import command reports misleading count
f4a2f87 Fix #274: Add automatic .beads/.gitignore upgrade (#300)
167ab67 Fix #328: Remove duplicate computeJSONLHash declaration
27c0c33 Fix #349: Improve compact error messages, remove bogus merge suggestion, add daemon/maintenance docs
f0d3d73 Fix 'landing the plane' instructions - emphasize git push is CRITICAL
7b63b5a Fix CI regressions and stabilize tests
345766b Fix FK constraint failures in AddComment and ApplyCompaction (bd-5arw)
09666b4 Fix FOREIGN KEY constraint failed when operating on non-existent issues
f3a678f Fix MCP schema generation recursion bug (GH#346)
8e05847 Fix TestRoutingIntegration and improve DetectUserRole robustness
4cd26c8 Fix Windows concurrent issue creation
1deaad1 Fix bd sync Windows upstream detection (#281)
a1e5075 Fix bd-ca0b: bd sync now auto-resolves conflicts instead of failing
0020eb4 Fix bd-khnb: Prevent auto-import from resurrecting deleted issues
d0e7047 Fix bd-lm2q: Use content-based comparison to prevent false-positive timestamp skew
944ed10 Fix bd-yvlc: in-memory database deadlock in migrations
d9904a8 Fix compact command failing with 'SQLite DB needed' error when daemon is running by removing premature store check and using ensureDirectMode for analyze/apply modes (closes beads-vlo) (#294)
a17e4af Fix context propagation lifecycle bugs
9e9db62 Fix daemon exiting after 5s on macOS due to PID 1 parent monitoring (GH #278)
8c1f865 Fix doctor incorrectly diagnosing hash IDs as sequential (issue #322)
8be792a Fix external_ref migration failure on old databases
934ae04 Fix gh-316: Prefer exact ID matches over prefix matches
6f7e7fa Fix lint errors: handle error return values
4e22214 Fix onboard test deadlock on Windows
1fc9bf6 Fix parallel test deadlock by removing t.Parallel() from TestCLI_* tests
ad2154b Fix prefix detection to only use first hyphen (bd-fasa)
a9b2f9f Fix race condition in auto-flush mechanism (issue bd-52)
b9919fe Fix: --parent flag now creates parent-child dependency
9dff345 Fix: Update DB mtime after import even with 0 changes (#296)
070107c Handle formatting errors in onboard renderer
4a8cbe8 How to resolve merge conflicts in .beads/beads.jsonl (source: Gemini 3)
445857f Improve FlushManager: constants, error logging, and functional tests
9088988 Improve staleness check error handling and optimization (bd-n4td, bd-o4qy, bd-c4rq)
9e57cb6 Improve type safety and fix minor issues in beads-mcp
20ffe60 Merge origin/main
811eb46 Merge remote changes
ddf58ca Merge remote changes
76e6dc9 Merge remote changes during sync
1458519 Merge remote-tracking branch 'origin/main'
4031e88 Merge remote-tracking branch 'origin/main'
8b0a8fa Merge remote-tracking branch 'origin/main'
6a562d5 Merge remote-tracking branch 'origin/main'
06b6f86 Merge remote-tracking branch 'origin/main'
e538dbd Merge show-rev-in-dev commit 'c922dc1ec32d5e3a470c22036891e239f4ab1350' into stable-fixes
2f6bccc Merge: Keep AGENTS.md with critical git push emphasis
5c177a4 Migrate to issues.jsonl
ed23f8f Optimize GetReadyWork to use blocked_issues_cache
968d9e2 Optimize bd list: replace N+1 label queries with bulk fetch
690c73f Performance Improvements (#319)
21a0656 Refactor AGENTS.md: Extract detailed instructions to prevent context pollution
d5239ee Refactor: Extract duplicated validation logic to internal/validation
bbfedb0 Refactor: extract duplicated validation and flag logic (bd-g5p7)
7b865eb Remove legacy issues.jsonl and update defaults to beads.jsonl
0617e58 Remove orphaned TestFormatDependencyType test
bd6dca5 Remove orphaned TestFormatDependencyType test
f4fbf6f Remove spurious and obsolete scripts
631c923 Resolve merge conflict in beads.jsonl
6cd3a32 Restore beads.jsonl to 538 issues from d99222d
d99222d Restore stable state: revert to beads.jsonl with 538 issues
4de9f01 Support local-only git repos without remote origin (bd-biwp)
7109c47 Track issues bd-1h8, bd-8ql, bd-ayw, bd-keb for GitHub #349
6422d4f Update bd JSONL
8952254 Update bd JSONL
800b0c3 Update bd JSONL
a630f9f Update bd JSONL
deaa463 Update bd JSONL
3c9cf95 Update bd JSONL
4223307 Update bd JSONL after closing 8-char hash issues
a5b7c51 Update beads issues
fcf37ba Update beads.jsonl after merge
e9f5a0c Update issues.jsonl
2156ed5 Update land the plane instructions to use 'bd cleanup' command
2f83815 Update vendorHash for Go module dependencies (#313)
2682fc7 add panic func in case of early exit
12dfa0b also report branch in dev version
fb1d12f bd cleanup: Remove 493 closed issues
052255a bd sync: 2025-11-09 12:55:37
d482d9e bd sync: 2025-11-09 14:13:48
83472ac bd sync: 2025-11-09 14:53:59
6d1c594 bd sync: 2025-11-10 10:21:27
3879296 bd sync: 2025-11-12 12:46:43
1c2e88c bd sync: 2025-11-15 13:19:53
59e635d bd sync: 2025-11-15 14:07:55
33b913f bd sync: 2025-11-15 14:13:53
4ba610d bd sync: 2025-11-19 09:48:30
ca52600 bd sync: 2025-11-19 15:01:56
c1542e9 bd sync: 2025-11-20 12:45:44
49a42a5 bd sync: 2025-11-20 12:47:14
4560f55 bd sync: 2025-11-20 14:25:18
1736f9f bd sync: 2025-11-20 18:58:07
221a7d4 bd sync: 2025-11-20 19:08:23
2503861 bd sync: 2025-11-20 19:11:36
bc2c351 bd sync: 2025-11-20 19:13:10
25e0ff6 bd sync: 2025-11-20 19:29:56
764886b bd sync: 2025-11-20 19:38:13
3520321 bd sync: 2025-11-20 20:22:39
e9aaf77 bd sync: 2025-11-20 20:32:52
bba7649 bd sync: 2025-11-20 20:33:30
d6bc798 bd sync: 2025-11-20 20:35:20
b2ee77f bd sync: 2025-11-20 20:38:15
94e60b1 bd sync: 2025-11-20 20:40:20
c547733 bd sync: 2025-11-20 20:59:31
be37a13 bd sync: 2025-11-20 21:47:55
0444271 bd sync: Update beads.jsonl after rebase
4a566ed bd sync: Update issue metadata
81c741b bd sync: apply DB changes after import
e36baee fix monitor-webui failure to detect running daemon
4b6ddb6 generated README.md
7d9ed9c merge upstream main
c922dc1 remove unrelated leftover file from agent
8d52f1d removed zombie backup
70c36f8 update beads db