gastownhall/beads v1.4.0-rc.2

on GitHub

beads v1.4.0-rc.2

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

Installation (release candidate)

This is a prerelease for validation. The stable install channels —
Homebrew, the install.sh / install.ps1 scripts, npm, and PyPI —
intentionally keep serving the latest stable release, so they will not
install this RC. Use one of the methods below.

Manual download (recommended):
Download the archive for your platform from the Assets below, extract it,
and place bd on your PATH.

Go install (pinned to this RC):

go install github.com/steveyegge/beads/cmd/bd@v1.4.0-rc.2
# For embedded Dolt support:
CGO_ENABLED=1 GOFLAGS=-tags=gms_pure_go go install github.com/steveyegge/beads/cmd/bd@v1.4.0-rc.2

1.4.0 is a one-way upgrade. Back up first. Consenting to the schema migration (bd migrate schema, --force, or BD_ALLOW_MIGRATE=1) moves a 1.2.x or 1.3.x store to schema v74. After that, bd 1.3.x and older refuse the database; going back means restoring a backup. From 1.4.0-rc.1, rc.2 is a binary swap: it adds no migration.

• Validate on a copy, or on a store you have backed up with your current bd (bd dolt push, a JSONL export, or bd backup sync).
• Every Dolt server bd talks to, and the dolt CLI on PATH, must be 2.6.0 or newer.
• Read Upgrade notes and Known issues under [1.4.0-rc.2] and [1.4.0-rc.1] in CHANGELOG.md before installing.

New in rc.2:

• bd github sync keeps local label edits again; this was a 1.4.0 regression.
• Server-mode pulls no longer write the remote URL, token included, into merge commits.
• Binaries are built with Go 1.27.4 (GO-2026-6859).

Behavior changes to know before installing:

• bd github now stops when a repository lookup fails. Rerun after a temporary failure. Never clear or repoint another repository's bead links to get past it: the next sync creates unlinked beads as new issues in the configured repository.
• Server-mode pulls need EXECUTE on dolt_fetch and dolt_merge.
• bd backup restore refuses a Dolt server on another host. Run it on the server's machine, in a workspace that names the same dolt_database.

Still open:

• #7283: in server mode, run bare bd migrate once per database if bd doctor reports a version mismatch after bd migrate schema.
• Go programs that link beads cannot open a proxied-server workspace (#8412, #8323).
• bd create --repo <url>'s cached clone still writes the URL into merge commits (#8434).

When 1.4.0 ships, install it by hand. bd doctor ranks 1.4.0-rc.N above 1.4.0 (#6595), so it will not tell you an upgrade is available.

Changelog

Bug Fixes

• 4b6e7f7 fix(backup): refuse a restore a Dolt server on another host would read unchecked (#7192 follow-up) (#8413)
• 1d6983a fix(dolt): server-mode pulls fetch and merge the tracking ref, not DOLT_PULL (bd-e2q8zs) (#8407)
• bfd3ef3 fix(github): #8068 follow-up — fail Init when a repository-name lookup gets no answer (#8399)
• 22f1221 fix(tracker): #8004 follow-up — a pull keeps a local label edit while GitHub's labels are unchanged (#8409)

Others

• beabc87 [release/1.4.0] chore(release): prepare v1.4.0-rc.2 (#8442)
• d296ce1 build(security): build with Go 1.27.4 for GO-2026-6859 (net/http) (#8431)