Beads Files

beads v1.0.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 beads

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

• [5e6096] feat(init): add --non-interactive and --role flags for CI/cloud agents
• [29531d] feat: GitLab sync — dedup fixes, type filtering, epic→milestone mapping, work item hierarchy (#2889)
• [7806fb] feat: add --non-interactive flag to bd bootstrap for CI (#2942)
• [677f7b] feat: add SlotSet/SlotGet/SlotClear to Storage interface (#2870)
• [c46be6] feat: add bd config set-many for batch config operations (#2943)
• [4d88e4] feat: add public format package for issue rendering (#2871)
• [08ee13] feat: add spike, story, and milestone as first-class issue types (#2923)
• [9b90ad] feat: export WispFilter type from root package (#2868)
• [8537d9] feat: migrate custom statuses and types to normalized tables (#2961)
• [73409d] feat: move hook firing into storage layer via decorator (#2891)
• [dc39fd] feat: support batch dep list for multiple issue IDs (#2875)
• [bf4025] feat: support comma-separated status values in bd list --status (GH#2846) (#2929)

Bug Fixes

• [d56bf0] fix(ado): apply --types/--states/--no-create filters to push operations (#2944)
• [9e34b0] fix(ado): create work items in initial state then transition to target
• [20b39b] fix(deps): migrate from lipgloss v1 to charm.land/lipgloss/v2
• [dc398f] fix(deps): update github.com/yuin/goldmark to v1.8.2
• [30cb4a] fix(deps): update module github.com/cenkalti/backoff/v4 to v5 (#2857)
• [933253] fix(dolt): add recovery guidance for diverged history errors (#2941)
• [ead8d0] fix(gitlab): resolve hardcoded work item type ID and O(n) milestone scan
• [a44d4f] fix(init): replace 'bd onboard' references with 'bd prime' in AGENTS.md (#2902)
• [41001f] fix(install): redirect log functions to stderr to fix WSL platform detection
• [5e751f] fix(lint): suppress gosec G122 false positive in noms LOCK cleanup
• [999f87] fix(test): remove tautological TestRoleFlagValidation
• [59b49c] fix: add missing //go:build cgo tags to embedded test files and cmd
• [872522] fix: add missing created_at index on wisp_events (GH#2760) (#2877)
• [1f4863] fix: add whitespace trimming to env var parsing in IsAutoStartDisabled (#2955)
• [2cd88e] fix: address PR review feedback
• [63c7a2] fix: adopt existing project_id when init --database targets shared server (#2925)
• [685cb8] fix: bd bootstrap detects remote data in fresh clones (GH#2792)
• [bbc812] fix: bump currentSchemaVersion to 11 for custom_statuses/custom_types tables
• [dbdc95] fix: clean stale noms LOCK files after bootstrap clone (bd-cmo)
• [dfa54a] fix: configure link checker root dir for docusaurus deploy
• [a2fc78] fix: make --yes/-y the primary flag in bd bootstrap, --non-interactive as alias
• [223895] fix: make bd setup claude project-local by default and auto-setup in bd init (#2935) (#2972)
• [0a1be3] fix: pass parent env vars to dolt-sql-server child process
• [4e4d95] fix: prefer bootstrap for missing database recovery (#2940)
• [2a71d7] fix: preserve spaces in embedded Dolt paths
• [543e19] fix: prevent concurrent embedded Dolt panic with exclusive flock (#2571)
• [33cab0] fix: recognize ado:NNNNN shorthand in IsExternalRef and ExtractIdentifier (#2966)
• [37382b] fix: remove bogus //nolint:gosec G122 directive (rule does not exist)
• [870cb8] fix: remove dead rig routing code and unused variable after rebase
• [ba46bd] fix: repair nightly test failures for TestInitCancel_E2E and dolt autostart (#2969)
• [ae77bd] fix: replace fragile string matching with typed APIError for HTTP status checks
• [163c27] fix: set ADO Severity field for Bug work items during sync
• [29bef7] fix: show blocked icon for dependency-blocked issues in bd list (#2858) (#2878)
• [265de3] fix: skip E2E test that requires Dolt server in embedded mode (#2888)
• [a09772] fix: suppress auto-backup address conflict warning (#2927)
• [baa9d0] fix: treat --shared-server as server mode for DoltMode (#2947)
• [9d9d0e] fix: unwrap HookFiringStore decorator before optional interface type assertions (#2937)
• [c17441] fix: update goreleaser owner to gastownhall (repo moved from steveyegge)
• [36e063] fix: update workflow gates from steveyegge/beads to gastownhall/beads (#2936)
• [299b5f] fix: use ResolveCustomTypesInTx in create path to honor YAML custom types (GH#2793) (#2930)
• [8cd247] fix: use proper RFC3339 timezone in WIQL date formatting (bd-wz8)
• [9f3b81] fix: use strconv.ParseBool for env var parsing in IsAutoStartDisabled (#2956)
• [ca6725] fix: validate graph plan node types against custom types (#2874)

Others

• [15f969] /cmd/bd/doctor: formatting
• [d326a2] /{.github,.goreleaser}: enable embedded by default on mac (#2971)
• [44c764] /{cmd,docs,internal}: more cleanup
• [f1bf09] /{cmd,docs,internal}: remove file removal that can cause data corruption
• [419164] Add --explain flag to bd ready for dependency-aware reasoning
• [5d524c] Add Integration Charter: define scope boundary for tracker integrations
• [6863ca] Add bd rules audit and bd rules compact commands (#2810)
• [bbd6c4] Add claude-workspace-snapshot to Claude Code Orchestration
• [7e4da9] Add credentials file support for Dolt server passwords (#2854)
• [2efa09] Add integration test coverage for partial failures, warnings, and self-deps
• [c5e033] Add pagination guards to Linear and context checks to Jira client
• [9d7882] Add release stability gate for upgrade safety (GH#2951) (#2963)
• [00b78d] Add retry logic to Jira client and jitter to all tracker HTTP clients
• [047e50] Enforce .beads/ directory permissions at runtime
• [0383ad] Enforce graph integrity: extend cycle detection and add bd graph check
• [ac4ee4] Expand SECURITY.md with tracker integration trust model
• [5708a3] Fix ADO Init tests leaking environment variables
• [ca1ae1] Fix init leaving beads.role unset in edge cases (GH#2950) (#2964)
• [558803] Improve compaction dry-run and analyze output with per-issue details
• [917c5f] Improve quickstart docs with Why Beads section and --explain examples
• [733b8f] Sanitize external tracker content for terminal display and add response size limits
• [8d41e7] Surface sync engine warnings in SyncResult and fix silent failure paths
• [dbcc2d] [codex] Fix installer ICU/CGO fallback handling (#2965)
• [d15b44] chore(deps): bump charm.land/lipgloss/v2 from 2.0.1 to 2.0.2 (#2919)
• [d02f1f] chore(deps): bump fastmcp from 3.1.1 to 3.2.0 in /integrations/beads-mcp (#2918)
• [721702] ci: fix macOS smoke test temp dir with dots in name
• [edb6f5] ci: retrigger after flaky Dolt lock contention in TestEmbeddedInit
• [ad53f3] cmd/bd: honor explicit repo selection for no-db commands (#2844)
• [73f786] github,ado: fix Retry-After jitter in retry loops
• [82c289] jira: add MaxPages pagination guard and fix Retry-After jitter
• [860ef5] lint: suppress gosec G404 for retry jitter (math/rand is fine for backoff)
• [db5b05] release: beads v1.0.0
• [11d366] tests: add coverage for explain logic, cycle detection, and engine warnings
• [4fc741] tests: add integration tests for config set-many mixed key routing and validation