beads v0.49.4

Pre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android/Termux (ARM64), and FreeBSD.

Installation

Homebrew (macOS/Linux):

brew install beads

Quick Install (macOS/Linux/FreeBSD):

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

• ebead133d8633ce3d7bf903bbfba293cf0a7a26a feat(bd): add wisp_type field support for TTL-based compaction (gt-7mqd.2)
• e8158aec3d22853a88bd349e4a288c8665e22a82 feat(cli): add --metadata flag to bd update (bd-0vud2)
• feae3bc46500e8ad085c283bdc74f18c40b74f10 feat(config): support .beads/config.local.yaml for local overrides
• 30e8c992f7122a6615b8ef9d774a6cc63c80ed51 feat(doctor): add Dolt migration validation checks (gt-nibe)
• 22e21c6ae3dc9302ce59cdd11acc40142a45123a feat(dolt): add BD_SKIP_ACCESS_LOCK env var for lock testing
• 8b24c125c0e77532a0c0979b06f097e41f9b0d95 feat(make): check repo is up-to-date before install
• 909085b3b33fe3dd07470b9a6af52ee280fdbfd1 feat(migrate): add agent-managed Dolt upgrade path
• c2ae767aaee8d0390d194d77fbde26a6ba016b99 feat(migrate): add orphan branch support for sync-branch mode
• 7e21aef75ab87cbb06b6ea9367215eaa36a29ed1 feat(migrate): make orphan branch default for bd migrate sync (#1148)
• e5c8c1d77263a002843d451ae4c8d4e919ffed28 feat(schema): add wisp_type column for TTL-based compaction (gt-7mqd.1)
• 51dc5ffed64a7a3e7833b5562f146f3901e840e0 feat: add 'beads' alias for bd command during installation
• 46b6b7a45efd294b6141b3677d2d72b168ef2cd0 feat: add --label-pattern and --label-regex flags to bd list
• fa1218d8a6fd1cfb7e0b3b5ab59d885a6ceb8fb2 feat: add Dolt schema migration runner (bd-ijw)
• f3874edee0a6feca5fe028f82d998bf49e438d98 feat: add simple query language for complex filtering
• cf185ce965c923a86d98f50dc1df6cae37307f45 feat: add spec_id field for linking issues to specification documents (#1372)
• a1c447eb66d72adde55309fbc2fc1ec29e124686 feat: add spec_id support
• dc038c9272adbbf81109cfee015fb55fa03f6948 feat: allow UpdateIssue metadata updates via json.RawMessage/[]byte (#1417)

Bug Fixes

• 7451ddc61c5db2f1a0ea3b5db2e1fd7657b3145b Merge PR #1279: fix: add JSONL file locking to prevent race conditions
• 0b92eae664d84050fb15f8b7a130bf2bd521732a Merge PR #1281: fix: add WAL checkpoint robustness with retry logic
• f220cb4670b8f9a7c279fcee30fd116878f0ab42 fix(autoflush): use unique temp file names for concurrent writes
• e48e94e248934a7f2c898c50ebc27c2e34f81f9c fix(compact): restore safety logic accidentally removed in cb1e3555
• b5ae6e8ea1d5e7e58cc2639a1a035f669dc87f7b fix(daemon): add initial JSONL import on startup with hash update
• 22bbbc474a2698db1b7fc3bf59878bac838df02e fix(daemon): update hash after auto-import to prevent export validation failure
• 4d9fced9da71a1b6d65a47fed6c8c05925c764bc fix(daemon_lock): update race test to document transient PID state
• 45647360938b8cb0cd502f3d600cf9c2b91e05f4 fix(dep): use factory.NewFromConfig for cross-rig dependency resolution
• 1ee9fbe59ef8f584a1c5342f84402f803dbb59d7 fix(doctor): use read-only mode to avoid creating database
• 6ec19436b38c9b05498d19eabad8364395ae0ed9 fix(dolt): add retry logic for server mode transient connection errors
• 1c2166ea4c0c1ccecebec76c950cd39033413db5 fix(dolt): add spec_id column migration for existing databases
• 9f2326b2bdb3ff12ca1cb515a8a9c1404c91a370 fix(dolt): add timeout to embedded Dolt close to prevent indefinite hang
• eaa4e7993f8675faa8acb53cf15c97a18b1da1fe fix(dolt): fix driver bad connection errors from nested queries in server mode
• 623c36b9ee6ecd2ae9c2765f217c4aaf3ce70bde fix(dolt): remove FK constraint on depends_on_id for external references
• 054e92d9f6b8ec0bc16424c614762254be710989 fix(dolt): use correct variable in initSchemaOnDB
• ead24289ef92a50f68d53695de697f4cf2d68cd6 fix(dolt): work around merge join panic in ready_issues view
• bc704608f38e4555e91312e368c530a45243cbf7 fix(lint): address unparam warnings in gitlab_sync.go
• bde38fde95087549fc9074d474dc86e836464c9e fix(lint): handle rows.Close() errors explicitly (G104)
• 70bc3844be21fb576eafafa11f87292746e00848 fix(lint): suppress G304 false positive for @file.json syntax
• 76e7aa25b5075551047b474dcab395aaeb695b71 fix(lint): use secure file permissions for lock file (G302)
• f3317a3cb46beb374ec57e575b7adedd5b0fa30b fix(migrate): use --stdin for cross-platform empty tree creation
• 1797e33396879baddfb6cfdf92931d91398de27a fix(nix): allow Go toolchain auto-download for version compatibility
• 4af28d54fabc482decfd4fe76c1386f31b96c00e fix(nix): use Go 1.25.6 overlay for dolthub/driver compatibility
• 24097e047a63b95e43901eef251455a483e7e968 fix(nix): use buildGoModule.override for go-modules derivation
• 703211320458cf797f2c8e009ac15550678857fd fix(path): exclude routes.jsonl from FindJSONLInDir fallback

Others

• 1a6beddbc834b703d39a925a3a4aa02f721abad9 Document ICU build deps and hint in installer (bd-1409)
• c761bc3c891f3d38381dec75cd2c302e97be6aa1 Document Windows Dolt limitation (main-3vt)
• fae6b4d975af914657e30c0719c307871553e316 Enable Dolt build on Windows via pure-go regex (main-3vt)
• b169256f2a3f3c5b5e40f4a12dd1ac52857f9fb6 Fix Windows build by excluding Dolt on Windows (main-3tg)
• 02f29ea898a08abf1511f44cc1fed9069c4be8f0 Fix auto-pull: check JSONL changes AFTER pulling
• ae5d13d0cab14256fd2731c950fc272c1b974f0c Fix daemon auto-import before export on mutation events
• 888e3e69eeb2848108e58d4e3ed9d8eddeb3fd5d Fix other instances of dolt db lock due to hanging process
• d8798a214afc5b075e6c018ee898f701c3f63071 Merge main into feature/bd-0vud2-cli-metadata
• cca086c9887b78bb1162f5fdfd7f3108825fc354 Merge main into refactor/merge-embed-types-issue-b2
• cca0dc9f0a2833ec378044bea1e20a5bb6d75b43 Revert "thinking about issue namespaces, GH#759"
• b7e0fc37e514260be3f1c3bb2b5e35e7e3e11904 Use prebuilt Windows releases in installer (bd-1493)
• beb805847eba2a9d29f1f8496da4adddfedbcbfe bd daemon sync: 2026-01-13 05:02:39
• c5cfe585590b7ace56240905c76d205982ea5487 chore(deps): bump github.com/anthropics/anthropic-sdk-go from 1.19.0 to 1.20.0
• 1278d435ff439a6370be8c90c1e415a1c61387a7 chore(deps): bump github.com/cenkalti/backoff/v4 from 4.2.1 to 4.3.0 (#1452)
• 3cbe2bdee7a530f63478f6c3fc79956354408e67 ci: allow Nix Flake test to fail temporarily
• 72b8632202484f7a09b120fafa53e0aaed57bbdd refactor(release): transform release.sh into molecule gateway
• 426fb965b6a5cf708d536a7ffb018b98a5e63612 refactor: merge driver embeds types.Issue to prevent field drift (#1481)
• 3032c622d2dec03843da03f45ce41d4ca6afc31d release: v0.49.4
• 8442a834826bbd94842b05a894b892568dbb0e82 revert: remove Go overlay, use continue-on-error instead
• 3bab4331bf82588a80f25a40cd5c5ad773130003 thinking about issue namespaces, GH#759