Beads Files

beads v0.49.0

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

Installation

Homebrew (macOS/Linux):

:::bash
brew install steveyegge/beads/bd

Quick Install (macOS/Linux/FreeBSD):

:::bash
curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash

Windows (PowerShell):

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

• [e00f01] feat(activity): use fsnotify for real-time feed (hq-ew1mbr.17)
• [9c3c21] feat(cli): add 'view' as alias for 'show' command (#1249)
• [a3ef77] feat(cmd): add 'bd children <id>' command (bd-scbxh)
• [e82e15] feat(config): add GetSyncMode, GetConflictStrategy, GetSovereignty with warnings
• [9ddd7a] feat(config): add validate command for sync config
• [e0dc3a] feat(create): add -m as alias for --description flag
• [1a7f8e] feat(doctor): add federation health checks (bd-wkumz.6)
• [4a0f4a] feat(doctor): add patrol pollution detection and fix
• [938a17] feat(dolt): add GetChangesSinceExport and CommitExists methods (bd-ejv83)
• [4f3c3f] feat(dolt): add federation prototype tests
• [cff58c] feat(dolt): add peer-to-peer federation integration tests (bd-wkumz.9)
• [90344b] feat(dolt): bootstrap routes.jsonl and interactions.jsonl (bd-lbdy7)
• [d3d232] feat(federation): add SQL user authentication for peer sync
• [da4584] feat(federation): add dolt sql-server mode for daemon (bd-wkumz.2)
• [c3f68c] feat(federation): enhance bd federation status command (bd-wkumz.5)
• [6190dd] feat(federation): implement bd federation sync command
• [ba0e75] feat(hook): implement per-worktree export state tracking (Design Part 21)
• [2fe15e] feat(hooks): add jujutsu (jj) version control support
• [ee4449] feat(linear): add --type and --exclude-type flags for sync filtering (#1205)
• [4e3e9d] feat(migrate): add SQLite to Dolt migration tooling (hq-ew1mbr.6)
• [c1ac69] feat(mol): add 'bd mol seed --patrol' command (#1149)
• [e36e2f] feat(nix): add shell completion outputs to flake (#1210)
• [d72f37] feat(rename): add bd rename command for renaming issue IDs
• [ce622f] feat(setup): add Codex CLI setup recipe (#1243)
• [63c2e5] feat(sync): add incremental export for large repos
• [9a9704] feat(sync): add per-field merge strategies for conflict resolution
• [16f8c3] feat(sync): add sync mode configuration (hq-ew1mbr.3)
• [c99bd0] feat(sync): implement interactive conflict resolution for manual strategy
• [356ab9] feat(sync): wire up sync.mode config to change sync behavior
• [bf92fd] feat(types): add FederatedMessage type for inter-town protocol (bd-wkumz.11)
• [4f0f57] feat(types): remove Gas Town types from core built-in types
• [d929c8] feat: add hierarchical tree display for --tree --parent combination (#1211)

Bug Fixes

• [1f8a6b] fix(autoimport): auto-correct deleted status to tombstone for JSONL compatibility (#1231)
• [f91bbf] fix(build): add CGO build constraints for Dolt-dependent files
• [b5178e] fix(build): disable CGO for darwin builds in goreleaser
• [83e3c7] fix(ci): resolve lint errors and test failures
• [38af99] fix(config): improve cross-platform path handling and regex efficiency
• [065ca3] fix(config): remove duplicate declarations and fix test failures (#1160)
• [033506] fix(config): restore sync.go with warning implementations
• [73d4d5] fix(create): validate explicit IDs against allowed_prefixes using starts-with matching (#1137)
• [ba832c] fix(daemon): Eliminate race condition in sync state load-modify-save (#1139)
• [8e4001] fix(daemon): Fix double-unlock risk in debouncer on action panic (#1140)
• [bb4549] fix(daemon): allow read-only daemon commands with Dolt backend
• [0eb3dd] fix(daemon): prevent stack overflow in handleStaleLock (#1238)
• [5264d7] fix(daemon): prevent zombie state after database file replacement (#1213)
• [460d2b] fix(doctor): improve diagnostic fix message output (#1187)
• [3824ab] fix(dolt): enforce single-process mode (disable daemon/autostart) (#1221)
• [2cc961] fix(dolt): parse timestamps from TEXT columns instead of direct time.Time scan
• [ea51c4] fix(federation): add configurable ports, password support, fix log leak
• [8807a1] fix(federation): allow daemon mode with --federation flag for dolt
• [cf6356] fix(init): error when redirect target already has database
• [abd3fe] fix(lint): check error return from provider.Close() (#1250)
• [0877e1] fix(list): stabilize tree ordering for consistent --tree output (#1228)
• [97d4b1] fix(migrate): address code review issues in Dolt migration
• [3daec7] fix(nix): bake shell completions into default package (#1229)
• [c11fa7] fix(orphans): honor --db flag for cross-repo orphan detection (#1200)
• [0b6df1] fix(ready): exclude molecule steps from bd ready by default (#1246)
• [d41fb3] fix(redirect): follow redirect when creating database (GH#bd-0qel)
• [be306b] fix(routing): auto-enable hydration and flush JSONL after routed create (#1251)
• [4ccdd7] fix(routing): close original store before replacing with target store (#1215)
• [f4ee7e] fix(routing): default to Maintainer when no git remote exists (#1185)
• [228d78] fix(routing): disable auto-routing by default (#1177)
• [824264] fix(sqlite): Add missing rows.Err() checks after row iteration (#1141)
• [4fffdb] fix(sqlite): add missing agent fields to scanIssues and related queries (#1176)
• [458fb7] fix(sqlite): handle text timestamps in scan for cross-driver compatibility
• [4bc0b6] fix(staleness): skip auto-import when store is read-only (GH#1089)
• [6a4a61] fix(sync): add --sparse flag to git add for worktree compatibility (#1143)
• [80cd1f] fix(sync): address code review issues in manual conflict resolution
• [f336e6] fix(sync): use sync-branch worktree for --full --no-pull (#1183)
• [1f5911] fix(sync): use town-level routes for prefix validation
• [9ed74c] fix(types): show custom types when daemon is running (#1216)
• [c8ffcc] fix(validation): accept prefix when it's a prefix of allowed entry (GH#1135)
• [f71349] fix(worktree): correct redirect path computation in bd worktree create (#1217)
• [2cbf3a] fix: Validate sync-branch at config-time and runtime (closes [#1166]) (#1168)
• [b63e7b] fix: auto-route create with explicit ID to correct database
• [b7242a] fix: load types.custom from config.yaml during init auto-import (GH#1225) (#1226)
• [b09aee] fix: set git index flags on init when sync-branch is configured (#1158)

Others

• [d3ccd5] Fix Dolt backend init/daemon/doctor; prevent accidental SQLite artifacts; add integration tests; clean up lint (#1218)
• [47a31a] /cmd/bd/daemon.go: remove debug logging
• [4e386c] /cmd/bd/doctor/integrity.go: fix unable to query issues bug with dolt backend
• [01fa2d] /cmd/bd/federation.go: fix windows build issue again
• [0a9bcc] /internal/importer/importer_test.go: remove skipped tests
• [767011] /internal/storage/dolt: fix windows build issue
• [7ed684] /{cmd,docs,internal,website}: make dolt backend explicitly single process
• [b849f5] /{cmd,docs,internal}: support import export for dolt backends
• [a097fc] /{cmd,internal}: fix lint issues
• [ba4328] /{cmd,internal}: get dolt backend init working and allow issue creation
• [422bc8] /{website,internal,docs,cmd}: integration tests and more split backend fixes
• [09355e] Add --gastown flag to bd doctor for gastown-specific checks (#1162)
• [46b167] Add .direnv folder to .gitignore (#1248)
• [e74cab] Fix CI failures (bd 1zo sandbox tests) (#1244)
• [34b741] Fix doctor DB-JSONL sync check to exclude ephemeral wisps (#1144)
• [aa3b31] Fix issue-prefix config fallback to config.yaml (GH#1145) (#1146)
• [1676f0] Merge origin/main into db/fix-2 (resolve conflicts)
• [8da7f2] docs(design): add KV store design for Dolt team review
• [ef162a] fix(GH#1224): detect Docker Desktop bind mounts in WSL2 and disable WAL mode
• [521239] refactor(config): improve sync config with warnings toggle and dedup
• [5d68e6] refactor(hook): simplify export state logic, add tests
• [4b2d17] refactor(hooks): consolidate duplicate JSONL file lists into shared constant
• [2a56aa] refactor(storage): move LocalProvider to internal/storage package
• [7cf671] refactor(types): remove Gas Town type constants from beads core (bd-w2zz4)
• [cb46db] refactor(types): use strings.Contains in federation tests
• [a0dac1] refactor: reduce cyclomatic complexity in repair.go and config_values.go (#1214)
• [de7300] test(dolt): add hub+spokes multi-clone integration tests