gastownhall/beads v1.3.3

on GitHub

beads v1.3.3

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

Release notes

Read the full notes in CHANGELOG.md: the [1.3.3] and [1.3.3-rc.1] sections. They cover the security fixes, data-loss fixes and dependency updates, the Upgrade notes on what commands now accept or print, and the Known issues with their workarounds.

Known issue found after release: GT_ROOT in .beads/.env is ignored

1.3.3 imports only an allowlist of keys from a project's .beads/.env (#7879). Gas City's gc rig add writes GT_ROOT=<city root> into each rig's .beads/.env, and 1.3.3 drops it. Every bd command in a rig prints beads: ignoring GT_ROOT from .beads/.env on stderr.

• Gas City agents are not affected beyond that warning. gc exports GT_ROOT into agent sessions itself, and the shell environment wins.
• When you run bd by hand in a rig without GT_ROOT exported, the city's formulas ($GT_ROOT/.beads/formulas) and town molecules are not found. The repo's own .beads/formulas and ~/.beads/formulas still work. Workaround: export GT_ROOT=<path to your city> before running bd in a rig.

Nothing else is affected: no data, Dolt server selection or credentials. A fix that allows GT_ROOT from .beads/.env is on its way to main (#8117).

Installation

Homebrew (macOS/Linux):

brew install beads

Quick Install (macOS/Linux/FreeBSD):

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

Windows (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

Others

• 10eec1f release(notes): align the v1.3.3 known-issue and gate notes with rc.1
• 04a9bd0 release: prep v1.3.3