github steveyegge/beads v0.30.6
on GitHub

latest release: v0.30.7
one day ago

beads v0.30.6

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

  • a89de1a feat(graph): add bd graph command for ASCII DAG visualization
  • 77d8a99 feat(graph): use subgraph to display dependency counts
  • efdfbac feat(mcp): consolidate admin tools to reduce token overhead (#634)
  • f4f51da feat(types): add StatusPinned for persistent beads (bd-6v2)
  • a68c52a feat: Add --assignee flag to template instantiate, fix mail inbox --identity
  • 23a14cc feat: Add --skip-preflight flag to workflow create
  • 6920cd5 feat: Add Beads template instantiation system (bd-r6a.2)
  • bc22d7d feat: Add workflow template system for agent-executable checklists
  • 3c04b76 feat: add merge-request issue type for refinery processing
  • eff58e4 feat: add no-push config to disable automatic git push
  • f7c746a feat: auto-protect forks from committing upstream issue database

Bug Fixes

  • 6716395 Revert "fix: Address workflow template issues from code review"
  • cb59bb3 fix(ci): resolve lint and test failures
  • 7f9ee3d fix(graph): traverse all dependency types, not just parent-child
  • dba9bb9 fix(import): handle duplicate issue IDs in JSONL files gracefully Implements three-layer deduplication strategy to prevent UNIQUE constraint errors during import: 1. Early deduplication during processing (importer.go) 2. Pre-batch deduplication (importer.go) 3. INSERT OR IGNORE with explicit error handling (issues.go) Problem: JSONL files with duplicate issue IDs caused import failures: Import failed: UNIQUE constraint failed: issues.id Root Cause: - Go SQLite driver returns errors even with INSERT OR IGNORE - Only content hash was deduplicated, not IDs - Multiple code paths affected (insertIssue, insertIssues) Solution: Layer 1: Early deduplication by ID in upsertIssues (lines 489-502) Layer 2: Pre-batch deduplication (lines 713-726) Layer 3: INSERT OR IGNORE + isUniqueConstraintError() helper Testing: - Multiple production databases tested - 9 duplicates handled successfully - 100% success rate on v0.30.5 databases - Zero UNIQUE constraint errors Impact: - Enables importing JSONL with duplicate IDs - Duplicate count shown in import statistics - No breaking changes, backward compatible 🤖 Generated with Claude Code
  • cb5ebfc fix(init): update output to show hash-based ID format
  • 8fa1eda fix(lint): add batch_ops.go to G201 exclusion
  • 2b0a8ce fix(lint): mark unused subgraph parameter in renderGraph
  • 973ecfc fix(lint): resolve golangci-lint errors for clean CI Fixes 5 linting issues to allow PR checks to pass: 1. hooks.go: Explicitly ignore error in async goroutine 2. 022_drop_edge_columns.go: Handle deferred PRAGMA error 3. flags.go: Add nosec comment for validated file path 4. create_form.go: Fix American spelling (canceled vs cancelled) 5. create_form.go: Explicitly mark cmd parameter as required by cobra These are pre-existing issues in the codebase, fixed here to enable clean CI for the import deduplication fix. 🤖 Generated with Claude Code
  • ef99f07 fix(lint): resolve golangci-lint errors for clean CI Fixes 5 linting issues to allow PR checks to pass: 1. hooks.go: Explicitly ignore error in async goroutine 2. 022_drop_edge_columns.go: Handle deferred PRAGMA error 3. flags.go: Add nosec comment for validated file path 4. create_form.go: Fix American spelling (canceled vs cancelled) 5. create_form.go: Explicitly mark cmd parameter as required by cobra These are pre-existing issues in the codebase, fixed here to enable clean CI for the schema probe fix. 🤖 Generated with Claude Code
  • d5e5694 fix(schema): add metadata and thread_id to dependencies expectedSchema Problem: Schema compatibility probe was failing with "no such column: thread_id" error when opening databases created before v0.30.5, even after running migrations. This caused database initialization to fail. Root Cause: The migration 020_edge_consolidation.go correctly adds the metadata and thread_id columns to the dependencies table, but schema_probe.go's expectedSchema map was missing these columns in its validation list. This caused verifySchemaCompatibility() to fail even though: 1. The columns existed in the actual schema (schema.go:51-52) 2. Migration 020 would add them if missing 3. The database was otherwise valid Solution: Updated expectedSchema in schema_probe.go to include "metadata" and "thread_id" in the dependencies table column list. This aligns the schema probe expectations with the actual schema definition and migration 020 behavior. Testing: ✅ Tested on 5 databases across version range pre-0.17.5 → v0.30.5 - All migrations completed successfully - Schema probe passes after migration - All bd commands work correctly ✅ No regressions in fresh database initialization Impact: - Fixes database initialization errors for users upgrading from v0.30.3 - No breaking changes or data migrations required - Compatible with all existing databases - Enables smooth migration path for all database versions Fixes database migration issues reported in v0.30.5 upgrade path. 🤖 Generated with Claude Code
  • 9dc34da fix(storage): add batch ID conflict detection and fix schema indexes
  • 6087cd4 fix(storage): race condition when reconnect closes db mid-query (GH#607)
  • e0872eb fix(test): remove incorrect duplicate ID rollback test
  • 2b031b9 fix(worktree): add -f flag to handle missing but registered state (#609)
  • aae8407 fix: Address workflow template issues from code review
  • 003a7d9 fix: Exclude closed issues from orphan detection warnings
  • 1e97d9c fix: Exclude tombstones from orphan detection warnings
  • b4a6ee4 fix: Include tombstones in DB count for stale check (bd-53c)
  • ede652d fix: Update remaining version files to 0.30.3
  • c573f7d fix: update nix vendorHash for Go dependencies

Others

  • e0d8abe Add tests for Decision 004 Phase 4 edge schema consolidation
  • ecd46a6 Add tests for Decision 004 Phase 4 thread traversal functions
  • 3ec517c Fix daemon/direct mode inconsistency in graph commands (bd-fu83)
  • fb16e50 Fix tests (bd-6ss and sub-issues) (#626)
  • 4981e84 Fix transaction.go AddDependency to match dependencies.go (Decision 004)
  • 2ea1b74 Merge beads-sync into main
  • 1f4b55d Merge main into fix/ci-errors, resolve graph.go conflict
  • d390aa8 Phase 1: Edge schema consolidation infrastructure (Decision 004)
  • 1d40b8f Phase 2: Dual-write for edge schema consolidation (Decision 004)
  • 5d7187f Phase 3: Migrate existing edge fields to dependencies (Decision 004)
  • 7c8b69f Phase 4: Remove deprecated edge fields from Issue struct (Decision 004)
  • 9382aa3 Update CLI reference with new --body-file options (#627)
  • 71ff52d bd sync: 2025-12-16 20:42:39
  • 2f0c746 bd sync: 2025-12-17 17:15:58
  • ed17cea bd sync: 2025-12-17 17:29:13
  • fe1e427 bd sync: 2025-12-17 19:09:58
  • 371783f bd sync: 2025-12-17 19:11:19
  • 8fb4a9d bd sync: 2025-12-17 19:16:21
  • 5227e9f bd sync: 2025-12-17 21:46:54
  • 2355bbb bd sync: 2025-12-17 22:56:45
  • a770777 bd sync: 2025-12-17 22:58:40
  • 243bc3f bd sync: 2025-12-17 22:59:19
  • e6a74ef bd sync: 2025-12-17 23:02:58
  • 4e3e80b bd sync: 2025-12-17 23:03:24
  • 8bdeb07 bd sync: 2025-12-17 23:03:53
  • 1e0151d bd sync: 2025-12-17 23:13:37
  • efb4782 bd sync: 2025-12-17 23:13:41
  • 2d2867d bd sync: 2025-12-17 23:15:18
  • cffa216 bd sync: 2025-12-17 23:18:36
  • f995cf5 bd sync: 2025-12-17 23:20:55
  • 0fd5d56 bd sync: 2025-12-17 23:24:34
  • f254511 bd sync: 2025-12-17 23:24:54
  • f76e61c bd sync: 2025-12-17 23:29:42
  • fd00a9b bd sync: 2025-12-17 23:38:05
  • bee04ef bd sync: 2025-12-18 00:41:18
  • f541785 bd sync: 2025-12-18 01:39:34
  • a3bad78 bd sync: 2025-12-18 01:42:06
  • eaa8b89 bd sync: 2025-12-18 01:45:02
  • 558bf9d bd sync: 2025-12-18 02:01:53
  • 51b3d39 bd sync: 2025-12-18 02:48:19
  • d5a115a bd sync: 2025-12-18 02:49:16
  • 001ae44 bd sync: 2025-12-18 11:09:54
  • 5981e6e bd sync: 2025-12-18 11:13:50
  • 1951a2c bd sync: 2025-12-18 11:28:36
  • 8b581d6 bd sync: 2025-12-18 11:29:45
  • acb3bbf bd sync: 2025-12-18 11:47:46
  • 736389b bd sync: 2025-12-18 13:47:56
  • d2b9554 bd sync: 2025-12-18 18:33:29
  • 8b0cd1e refactor(import): remove redundant pre-batch deduplication layer
  • 125e36d refactor(onboard): simplify to minimal snippet pointing to bd prime
  • 0d6b3d7 refactor: Remove YAML template system entirely
  • 68bd057 refactor: Remove YAML workflow system (bd-r6a.1)
  • 83ae110 refactor: Remove legacy MCP Agent Mail integration (bd-6gd)
  • ba8beb5 test(coverage): add tests to meet 45% CI threshold
  • 5316559 test(graph): add tests for graph utility functions
Check out latest releases or
releases around steveyegge/beads v0.30.6

Don't miss a new beads release

NewReleases is sending notifications on new releases.

Get notifications