Beads v0.60.0 Released

[steveyegge]

Beads v0.60.0

Beads v0.60.0 is now available with binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android/Termux (ARM64), and FreeBSD.

Installation

# Homebrew
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

Highlights

• GitHub Issues integration — New tracker plugin (bd setup) syncs beads with GitHub Issues.
• bd bootstrap — Automated recovery that executes repair actions instead of just printing advice.
• bd context — New command with safe-first error guidance.
• JSON-aware error output — Structured errors + JSONL schema validation + contract tests.
• Epic close guards — Merge re-parenting and progress display when closing epics.
• OS-assigned ephemeral Dolt ports — Replaces the old hash-derived port scheme, eliminating birthday-problem collisions.
• bd done <id> <message> — Treats last arg as close reason for faster workflow.
• --design-file flag — Read design documents from files.
• --destroy-token — Safe non-interactive re-init.
• bd help --list / --doc — CLI doc generation flags.
• bd search on external_ref — Search by external reference (e.g., GitHub issue URL).
• Global PRIME.md fallback — Support for ~/.config/beads/PRIME.md.

Key Fixes

• Auto-commit pending changes before pull to prevent merge errors.
• --json flag now works correctly with --tree default.
• Stale bd sync references cleaned up across CLI help and docs.
• Dependency updates (dolthub/driver, opentelemetry-go, testcontainers-go, golang.org/x/*).
• Doc validation CI to catch stale references going forward.

Full changelog and binaries: https://github.com/steveyegge/beads/releases/tag/v0.60.0