steveyegge/beads v0.23.0

on GitHub

beads v0.23.0

Pre-compiled binaries for Linux, macOS (Intel & Apple Silicon), and Windows.

Installation

Homebrew (macOS/Linux):

brew install steveyegge/beads/bd

Quick Install (macOS/Linux):

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

Manual Install:
Download the appropriate binary for your platform below, extract it, and place it in your PATH.

Changelog

Features

• ef8585b feat: Add automatic Homebrew formula update to release workflow
• a03737c feat: Add bd info --whats-new for agent version awareness (bd-eiz9)
• 6355ee1 feat: implement agent-driven compaction (bd-buol)

Bug Fixes

• d8c0426 fix: remove unnecessary cd commands (#257)

Others

• 6aa7cf4 Add 'new' as alias for 'create' command
• f12004c Add Agent Mail 98.5% git traffic reduction metric to changelog and README
• c3856bb Add Agent Mail documentation and bash-agent integration
• d6aa078 Add Agent Mail failure scenario tests (bd-zi1v)
• 620d96f Add MCP server functions for repair commands (bd-7bbc4e6a)
• e6dfcc6 Add Python cache files to .gitignore
• fe705be Add RPC diagnostics with BD_RPC_DEBUG env var
• 770e090 Add docs/ directory to links (#242)
• 3bce313 Add automated git traffic benchmark for Agent Mail
• 1065e66 Add bd cleanup command for bulk deletion of closed issues
• 187fdd2 Add bd hooks install command with embedded git hooks (bd-908z)
• 3e207df Add cleanup script for test pollution (bd-vxdr)
• a236558 Add client self-heal for stale daemon.pid
• 068615f Add comprehensive Agent Mail adapter tests (bd-5ki8)
• bc056ce Add comprehensive Agent Mail coordination tests (bd-pdjb)
• 24bfb6a Add comprehensive tests for Python Agent Mail adapter
• 93c90a4 Add dependencies for Agent Mail integration issues
• ef94641 Add multi-agent race condition test (bd-zo7o)
• f6dbcd1 Add test safeguards to prevent production database pollution (bd-2c5a)
• 46dbdc0 Add version number to beads-mcp startup log
• 87e4ae5 Add warning message to zombie issues.jsonl file
• 9ee45e1 Auto-invoke 3-way merge for JSONL conflicts (bd-jjua)
• e6d580e Change bd list to one line per issue, add --long flag
• 4e97e0e Clarify Agent Mail is external service, not embedded in beads
• e6e458f Close bd-27xm, update bd-6hji, file bd-8zf2 (MCP context bug)
• a47b69e Close test issues
• 37f9d36 Complete Agent Mail documentation (bd-nl8z)
• 773aa73 Document external_ref in content hash behavior (bd-9f4a)
• 73e73ae File bd-srwk: Prevent stale database exports
• 6408ef6 Fix #249: Add nil storage checks to prevent RPC daemon crashes (#250)
• b02a1ff Fix #258: Allow completion commands without database
• a31715c Fix .gitignore to exclude git merge driver temp files
• 046e852 Fix GH#254: bd init now detects and chains with existing git hooks
• d97df21 Fix MCP server integration tests - add env variable propagation
• 64742cd Fix SQLite driver name mismatch causing "unknown driver" errors (#252)
• 62643ea Fix Windows MCP subprocess timeout for git detection (bd-r79z)
• d3de551 Fix Windows SQLite support in releases
• ab4ec90 Fix bd import to auto-initialize database when missing
• ba2aef4 Fix bd-8kde: disable auto-import during delete operations
• 44179d7 Fix bd-8zf2: MCP server auto-detects workspace from CWD
• eeef37f Fix bd-srwk: Add ID-based staleness detection to bd export
• f72a1d8 Fix bd-u4f5: Add warning when import syncs with working tree but not git HEAD
• e95885f Fix bd-yuf7: Add config to bd info JSON output
• c81c165 Fix beads-mcp workspace context persistence and buffer overflow
• 7fa0c93 Fix daemon orphaning: track parent PID and exit when parent dies
• abb1d1c Fix post-merge hook to show actual error messages
• 0e8936b Fix test failures: update to new AddDependencyParams field names
• 4907c59 Gitignore Formula/bd.rb - auto-generated by GoReleaser, real source is homebrew-beads tap
• f79735d Ignore Python cache in integration tests
• e7f532d Implementing an RPC monitoring solution with a web-ui as implementation example. (#244)
• bfc0320 Merge remote changes
• ced2a6c Merge remote changes after test pollution cleanup
• 1da414f Merge remote changes and add TTL/expiration tests (bd-d6aq)
• 2618f9f Prepare v0.23.0 release: update CHANGELOG and remove artifacts
• 0106371 Prevent nested .beads directories (bd-eqjc)
• c416c7d Prevent test pollution in production database (bd-z528)
• f6bdf7c Reduce RPC dial timeout from 2s to 200ms for fast-fail (bd-expt)
• 826a3b2 Refactor AGENTS.md: extract supplemental docs
• f862071 Refactor snapshot management into dedicated module (bd-urob)
• 497f12f Remove old install.sh script, replaced by bd hooks install
• 3191c9c Remove vc.db exclusion from FindDatabasePath filter
• ba1b856 Standardize daemon detection with tryDaemonLock probe (bd-wgu4)
• 2db2203 Sync bd issues
• bd59973 Sync beads database
• d9db975 Sync beads database after merge
• c864527 Update JSONL after closing bd-zo7o
• 93e5a15 Update bd JSONL
• 33c3b05 Update bd JSONL
• 08ae95b Update bd JSONL
• 1c86fc1 Update bd JSONL
• de665f2 Update bd JSONL
• a1ef05d Update bd JSONL
• 78d3f5f Update bd JSONL (closed bd-z528)
• 3b326ca Update bd JSONL - closed bd-ic1m
• 27fd6e4 Update beads JSONL after closing bd-d6aq
• df8ad12 Update beads issues - close bd-tuqd (GH#254 fix)
• af11521 Update beads.jsonl with closed issues (bd-eimz, bd-fkdw, bd-sc57)
• 367bf07 Update hook templates and whats-new data to v0.23.0
• 687c23c Update issues (bd-2cvu closed)
• 769cd7b bd sync: 2025-11-06 22:23:46
• 19da81c bd sync: 2025-11-07 00:28:01
• ba87533 bd sync: 2025-11-07 09:50:03
• 0815ac2 bd sync: 2025-11-07 15:55:36
• cdecc02 bd sync: 2025-11-07 15:56:20
• 86d48a1 bd sync: 2025-11-07 16:03:56
• 705fcc0 bd sync: 2025-11-07 16:08:11
• 36919da bd sync: 2025-11-07 16:08:36
• f1f144d bd sync: 2025-11-07 16:08:52
• a6c9579 bd sync: 2025-11-07 18:57:35
• 9eab271 bd sync: 2025-11-07 19:05:05
• 5283370 bd sync: 2025-11-07 19:07:55
• 3431cd4 bd sync: 2025-11-07 21:29:32
• 6f22c96 bd sync: 2025-11-07 21:29:59
• 4f442ce bd sync: 2025-11-07 22:44:23
• e5e0c8a bd sync: 2025-11-07 22:51:08
• 07bd706 bd sync: 2025-11-07 23:10:55
• 0e6cb2d bd sync: 2025-11-08 00:00:04
• 139c693 bd sync: 2025-11-08 00:11:03
• 29a3dfe bd sync: 2025-11-08 00:50:07
• ef1634d bd sync: 2025-11-08 01:02:24
• 6970fff bd sync: 2025-11-08 01:03:44
• 7d5ea2e bd sync: 2025-11-08 01:52:48
• ce2afd1 bd sync: 2025-11-08 01:58:15
• 5793ec3 bd sync: 2025-11-08 02:20:47
• 9d9386f bd sync: 2025-11-08 02:22:18
• 00333ce bd sync: 2025-11-08 02:24:17
• 3b39672 bd sync: 2025-11-08 02:28:57
• 288d62a bd sync: 2025-11-08 02:51:36
• 709fd1d bd sync: 2025-11-08 03:11:53
• 54b459a bd sync: 2025-11-08 03:12:12
• a02467e bd-muls: Add Agent Mail integration tracking
• 00f045a bd-vcg5: Add daemon crash recovery with panic handler + socket cleanup
• 9351044 feat(agent-mail): Add Python adapter library for Agent Mail integration