Beads Files

beads v1.0.3

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

Installation

Homebrew (macOS/Linux):

:::bash
brew install beads

Quick Install (macOS/Linux/FreeBSD):

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

Windows (PowerShell):

:::powershell
irm https://raw.githubusercontent.com/gastownhall/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

• [72b6cf] feat(gate): add 'bd gate create' for ad-hoc blocking gates (#3257)
• [8b691b] feat(prune): add bd prune for deleting closed non-ephemeral beads (#3353)
• [8518e7] feat: BD_JSON_ENVELOPE=1 opt-in for uniform JSON wrapping (#3393)
• [0d4b97] feat: JSON schema contract, bd ping, structured errors, import enhancements (#3368)
• [34a580] feat: add --exclude-label flag to bd ready and bd list
• [73d72e] feat: add --remote flag to bd dolt push/pull commands (#3211)
• [a54ab6] feat: add starter formula examples (#3248)
• [5715f5] feat: make CGO_ENABLED=0 the blessed go install path (GH#3303)
• [a78e58] feat: support Unix domain sockets for Dolt server connections (#3300)

Bug Fixes

• [397eb4] fix(ado): use date-only format for WIQL ChangedDate queries (#3345)
• [7bd9e1] fix(audit): use atomic write to prevent torn lines under concurrent O_APPEND (#3301)
• [0dce51] fix(autopush): bound auto-push, throttle failed attempts (#3370) (#3381)
• [80255b] fix(bootstrap): clone via SQL server in external server mode (#3346)
• [813fdf] fix(ci): unblock main — gosec G122 + credentials_test signatures (#3389)
• [165bd6] fix(config): default Dolt database name when metadata.json is missing (#3380)
• [66da48] fix(config): reject issue-prefix config set
• [5affdb] fix(doctor): resolve Dolt password/TLS for externally-hosted servers (#3361)
• [d57dc7] fix(dolt): auto-recover from corrupt manifest on startup (GH#3290) (#3327)
• [be8eda] fix(dolt): bd dolt status recognizes externally-hosted Dolt servers (#3362)
• [456a66] fix(dolt): disable auto-push by default; require explicit opt-in (#3446)
• [395935] fix(dolt): exit 0 when push/pull finds no remote configured (GH#3031) (#3194)
• [add175] fix(dolt): pre-push integrity check via dolt fsck (#3447)
• [f99013] fix(export): add _type discriminator to JSONL issue lines (#3272)
• [d0f0ad] fix(export): scrub git hook env and skip cross-worktree git-add (GH#3311) (#3347)
• [bc74f7] fix(fetch): run GC after failed DOLT_FETCH to prevent tmp_pack_* accumulation (#3326)
• [5b4b8a] fix(formula): auto-register custom types used by formula gate steps (#3214)
• [6681fd] fix(formula): carry step metadata through cook and pour (GH#3341) (#3359)
• [fef739] fix(gate): keep dry-run checks write-free
• [5c4362] fix(hooks): preserve husky v8/v9 hook layout when copying to .beads/hooks/ (#3197)
• [c6d0cc] fix(init): refuse --force when remote has Dolt history (#3455)
• [3c6c9d] fix(init): skip hooks during from-jsonl bootstrap commit (#3342)
• [c446a2] fix(linear): harden push against data clobbering (#3328)
• [4e3dbb] fix(nix): update vendorHash after dependabot go.sum bumps (GH#3221) (#3297)
• [9db6b5] fix(schema): repair v0.63→v1.0 upgrades where issues.started_at is missing (GH#3363) (#3365)
• [39ee50] fix(setup): add alwaysApply frontmatter to Cursor rules template (GH#3191) (#3193)
• [e31233] fix(setup): skip duplicate hooks when beads plugin is installed (GH#3192) (#3196)
• [baf73a] fix(worktree): don't prefer inherited .beads/ over shared fallback (#3425)
• [dbf793] fix: auto-sanitize hyphenated dolt_database on embedded-mode upgrade (#3231) (#3232)
• [e585a6] fix: avoid false shared-server bootstrap no-op for synthesized worktrees
• [43c1dc] fix: bd config set --db <path> now resolves BEADS_DIR for yaml-only keys (#3348) (#3379)
• [dfde51] fix: bd dolt pull fails when remote added without branch tracking (#3443)
• [98173b] fix: bd list --parent no longer echoes parent when it has no children (#3349) (#3374)
• [2c0fa6] fix: bd update --type honors custom types (fixes [#3030]) (#3093)
• [0e0959] fix: cross-rig prefix routing for issue resolution via routes.jsonl (#2954)
• [1e76ef] fix: don't normalize user-provided sync.remote URLs (GH#3339) (#3432)
• [027172] fix: linear tracker reads yaml-only config keys from config.yaml (#3315)
• [a0c00d] fix: make beads-mcp shared-worktree aware
• [27e9a8] fix: no-git-ops=true now implies export.git-add=false (#3314) (#3376)
• [a42ede] fix: pass CLI filters through tree mode recursive walk (#3384)
• [ffe69a] fix: promote gate to built-in type so formula pour works (#3382)
• [3c67e8] fix: rebind selected workspace before db command startup (#3230)
• [0d7f87] fix: remove duplicate database name helper (bd-rrt)
• [7516a3] fix: remove orphan detection from compat migration hot path (#3344) (#3378)
• [6bda86] fix: show (none) placeholder when description is empty in bd show (#3336) (#3375)
• [8abad9] fix: skip DOLT_COMMIT when compat migrations produce no changes (#3366) (#3373)
• [20b9ed] fix: support Jira Cloud token pagination (#3456)
• [5aa4eb] fix: use routed ID resolution in bd comments (#3385)
• [5f0be2] fix: warn on unrecognized config keys in bd config set (#3293) (#3377)
• [f368f9] fix: wire embedded backend compat migrations by relocating runner (#3413)

Others

• [b76947] /.github/workflows/ci.yml: update comment
• [c486c7] /default.nix: update vendor hash
• [c12972] /{examples,go.mod}: bump go
• [74ad12] Add ADO round-trip integration tests and config documentation (#3305)
• [390658] Add Linear round-trip fidelity integration test (upstream [#3187]) (#3255)
• [6e506b] Add PR preflight and contributor intake guidance (#3470)
• [cfdb75] Fix git-remote-cache tmp_pack file leak in embedded mode (#3355)
• [55625d] Fix worktree-aware config.yaml resolution (#3265)
• [abf03e] Keep regular epics open after the last child closes (#3276)
• [1b2dd2] Release 1.0.3
• [df25aa] Rename ICU-only test path to explicit opt-in workflow (bd-b18) (#3291)
• [ac085d] Skip Dolt remote registration for plain git source repos during init (#3357)
• [04ec3f] Tier embedded Dolt CI for PRs (bd-0gz) (#3459)
• [578524] [codex] Diagnose Dolt journal corruption and init lock hangs (#3457)
• [63a24b] [codex] Share epic DB setup in one suite (#3296)
• [3f866c] add Thread to community tools - analytics and observability (#3329)
• [2ade22] chore(build): codify the gms_pure_go build-tag policy (GH#3303)
• [a6152f] chore(deps): bump actions/checkout from 4 to 6 (#3320)
• [5a51e3] chore(deps): bump actions/upload-pages-artifact from 4 to 5 (#3318)
• [37d30f] chore(deps): bump charm.land/lipgloss/v2 from 2.0.2 to 2.0.3 (#3325)
• [632839] chore(deps): bump fastmcp from 3.2.3 to 3.2.4 in /integrations/beads-mcp (#3319)
• [8b5d54] chore(deps): bump github.com/anthropics/anthropic-sdk-go (#3322)
• [e4f073] chore(deps): bump go.opentelemetry.io/otel/exporters/stdout/stdoutmetric (#3323)
• [e3c26c] chore(deps): bump golang.org/x/term from 0.41.0 to 0.42.0 (#3324)
• [cf4209] chore(deps): bump pydantic in /integrations/beads-mcp (#3321)
• [4c240f] chore(gitignore): ignore .codex marker and .claude/*.lock
• [b90ee4] ci: add nix build check to catch vendorHash drift (GH#3298) (#3364)
• [15f31d] ci: don't fail workflows when codecov upload has no token (#3386)
• [f0057c] ci: install dolt binary on Linux and macOS test runners (#3440)
• [26829e] ci: install dolt in regression workflow
• [8b3084] cleanup(agents): Delete spurious cmd/bd/@AGENTS.md file (#3198)
• [27c333] docs(test): reference GH#3260 investigation near memory race workaround (#3287)
• [ecd2f7] fix packaging and windows install regressions
• [aed707] fix remote sync follow-ups
• [86d551] fix(admin,dolt): allow admin + dolt show/status in embedded mode (#3330)
• [0b9d5a] fix(go.mod): remove broken replace directive that blocks go install (GH#3303)
• [331bc3] perf(storage): amortize per-ID wisp routing via WispIDSetInTx (#3453)
• [d8d298] refactor: extract create issue build and dry-run render helpers (bd-itp.4) (#3295)
• [e3586d] refactor: route duplicate commands through CommandContext accessors (bd-itp.2) (#3294)