Unclaimed project
Are you a maintainer of beads? Claim this project to take control of your public changelog and roadmap.
Claim this projectChangelog
beads
Beads - A memory upgrade for your coding agent
agentsclaude-codecoding
Last updated about 20 hours ago
Back to changelogNew
v0.49.4
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 testing8b24c125c0e77532a0c0979b06f097e41f9b0d95 feat(make): check repo is up-to-date before install909085b3b33fe3dd07470b9a6af52ee280fdbfd1 feat(migrate): add agent-managed Dolt upgrade pathc2ae767aaee8d0390d194d77fbde26a6ba016b99 feat(migrate): add orphan branch support for sync-branch mode7e21aef75ab87cbb06b6ea9367215eaa36a29ed1 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 installation46b6b7a45efd294b6141b3677d2d72b168ef2cd0 feat: add --label-pattern and --label-regex flags to bd listfa1218d8a6fd1cfb7e0b3b5ab59d885a6ceb8fb2 feat: add Dolt schema migration runner (bd-ijw)f3874edee0a6feca5fe028f82d998bf49e438d98 feat: add simple query language for complex filteringcf185ce965c923a86d98f50dc1df6cae37307f45 feat: add spec_id field for linking issues to specification documents (#1372)a1c447eb66d72adde55309fbc2fc1ec29e124686 feat: add spec_id supportdc038c9272adbbf81109cfee015fb55fa03f6948 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
- 5f8cb4cf342ce04602c4fca1684fc25ffead1c31 fix(routing): respect BEADS_DIR over prefix routing in show/close/update
- aa5e92f84ce8f5954b1d0e5567204ba2e210d748 fix(show): display relates-to deps correctly and deduplicate RELATED section
- 69bf2c96035a43a0c8c598ce8bda56860d69ef5c fix(sync): disable JSONL auto-flush in dolt-native mode (bd-zlih1)
- 1c02b4e44be333c377aff4c4341299a3996a544c fix(sync): disable JSONL imports in dolt-native mode, keep local writes as safety net
- cd9768d4562413f37487667ac8db943b4e87112a fix(sync): disable JSONL sync exports in dolt-native mode (bd-zlih1)
- 2726e6b63f91b297ce9a5907def0921bfe388495 fix(sync): use GetGitCommonDir for worktree creation in bare repo setups
- c5953db62db80d7d74ca91c8d5a84c4b6f346fe9 fix(sync): use content-based merge for daemon pulls (GH#1358)
- 665863e7d8b786b47996d97bba0b99ec3b2b9130 fix(test): create database before use in migrations_test.go
- 6f89e6559e7c87cc26a49c241dc902cf9660f44c fix(test): use atomic counter in TestFetchIssues_ContextCancellation
- f5b702530211e82c354354f2d2516fcd47dc786d fix(test): use atomic counter to fix data race in gitlab test
- 047174ec908ef99cd4c287b705a5cf9686fe0019 fix(update): add config.yaml fallback for custom types in daemon mode
- 001a6aebc0e295bf62bd7fa99deda881f6868c96 fix: accept simple string vars in TOML [vars] section
- 26bed833568cfd22f365b894857ebd4a7bb80f49 fix: add JSONL file locking to prevent race conditions
- 7165f311f3c078d590c54dbb16071aabed42a2c4 fix: add JSONL locking to performIncrementalExport
- 9e397bca93deba7020e912cbe583d3a5e7e1e9aa fix: add WAL checkpoint robustness with retry logic
- c96e62e6b59cc82a1ee244a98ff450d9ec294d9b fix: add atomic compare-and-swap semantics to bd claim (#1474)
- 690adbba053c4faa9df56661f69c221896cb266f fix: add missing placeholder for spec_id in Dolt INSERT
- 8457d9ea7da3a88f91bacfcd753068d6c429d668 fix: add missing spec_id to SQL queries using scanIssues
- 6b46f3abb4d005900e16e423a8224b020c5ad51b fix: add process-level semaphore to limit concurrent dolt access (G5)
- bb18dad195a23ba56fcb9d5777b2fea6e1e2dbdb fix: add routes.jsonl to FindJSONLInDir skip list to prevent corruption
- 823efe63cafd06d4e2f8f4fbadd4e58c4be5d863 fix: add toml tags for snake_case fields in formula structs
- 7dcfb1c006be4a7562e2f4da9a7b568d5cf79ece fix: add transaction safety and daemon lock improvements
- 5619c504b038a100c8fd0197b2b149cf1c3cad8f fix: add wisp_type to Dolt GetIssuesByIDs and insertIssueTx queries
- 1269368593f864c826a01d2fd783b1c88844fb1b fix: advisory flock to prevent zombie bd processes from dolt lock contention
- 9acaa854dfdc4ff7cd6820961d9f4ad70681ea9c fix: align resolve_conflicts tie-breaking with merge driver (#1481)
- 2aff2dbc01832cb1285953d8a5851ed71210b5b2 fix: bd cleanup --hard always prunes tombstones immediately (bd-4q8)
- 4b80094dd58e7ed9f563ab070f086918fd6959dc fix: bd ready now excludes in_progress issues to show only claimable work
- 92d1e596e32dd56095ea50c518f2fe5ae9f4b434 fix: deduplicate children in bd list --tree
- 49cf54ec0080d73c527069a6327acc0807221ae2 fix: enable govet linter and resolve all IPv6 address format issues
- dfeac38bc6bb920a0dfd3621c2e87d6ba78d4e03 fix: merge driver silently drops issue fields (#1480)
- f013db991fe58bd6bbef23e7a6e6f6583ba2b3c1 fix: merge driver silently drops issue fields (#1480) (#1482)
- ed71a9abc682aed755beee7218162bbcfde38ac6 fix: remove unused source return value from getGitLabConfigValue (unparam)
- 60978cfbad460f989ffb0dcd13259b9bebf7e5f4 fix: replace daemonLogger with *slog.Logger for proper structured logging
- 62c9f9bccb45e743fff0c5e8845bbc1bfa23578c fix: resolve all CI failures (lint, tests, nix) (#1464)
- 87a22e08ebd6253571ec5571ec763284c93d1774 fix: resolve connection pool deadlock in dolt dependency resolution (G10)
- c2f3d46eda37af20a3b4aea94dd97277b45de0b9 fix: resolve errcheck violations in cmd/bd/gitlab.go and gitlab_sync.go
- 309bab48dbb636b53b61172aceb5de78106362c7 fix: resolve failing tests in daemon autostart, gitlab, and syncbranch
- 3db3d2c24f8a321aa0173dd73a5b671bf4997035 fix: resolve gosec G104 unhandled rows.Close() error in doctor/perf_dolt.go
- b169dc113502541cba0b309beff7b33637375dbf fix: resolve gosec G104 unhandled rows.Close() errors in dependencies.go
- a7f9e8631966701ae30948263594fa2f69fee05c fix: resolve remaining errcheck violations in gitlab files
- 789ffe7221c8519fb3e17d005dbef756bc6dd690 fix: resolve unused ctx lint warning in filterByLabelRegex
- 78b657c953fdd18fd1ce2543e794960b74d1465b fix: scope Dolt migration helpers to current database (bd-0gfm6)
- 74920a8bd0f4b8f918d96a290b9843c1ab259aee fix: skip CREATE DATABASE for read-only commands in dolt store
- 0bca2f5b524738e50431b9a7862903db89cc5d26 fix: use types.Dependency end-to-end, add JSONL round-trip tests (#1481)
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