From a46c1db86eaf64c4d52a95f034c5fa6d86863667 Mon Sep 17 00:00:00 2001 From: Pablo LION Date: Mon, 9 Feb 2026 08:02:42 +0100 Subject: [PATCH] fix: correct brew commands and remove dead homebrew CI job MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Homebrew formula is named "beads" (not "bd"), so all brew commands must use `brew install beads` / `brew upgrade beads`. Also removes the dead update-homebrew job from release.yml — homebrew-core handles formula updates automatically. Follows up on #1557 which fixed the Go code in bd doctor. Co-Authored-By: Claude Opus 4.6 --- .github/workflows/release.yml | 69 ------------------- AGENT_INSTRUCTIONS.md | 2 +- RELEASING.md | 2 +- build-docs.md | 2 +- .../skills/beads/resources/TROUBLESHOOTING.md | 2 +- docs/INSTALLING.md | 4 +- docs/RELEASING.md | 2 +- scripts/README.md | 2 +- website/docs/getting-started/installation.md | 2 +- website/docs/getting-started/upgrading.md | 2 +- website/static/llms-full.txt | 6 +- 11 files changed, 13 insertions(+), 82 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 6a11133da..1d5cc1827 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -107,72 +107,3 @@ jobs: # Uses OIDC trusted publishing - no token needed # Provenance attestations are automatic with trusted publishing - update-homebrew: - runs-on: ubuntu-latest - needs: goreleaser - if: ${{ github.repository == 'steveyegge/beads' }} - steps: - - name: Checkout - uses: actions/checkout@v6 - with: - fetch-depth: 0 - - - name: Get release info - id: release - run: | - TAG="${GITHUB_REF#refs/tags/}" - echo "tag=${TAG}" >> $GITHUB_OUTPUT - echo "version=${TAG#v}" >> $GITHUB_OUTPUT - - - name: Download checksums - run: | - curl -sL "https://github.com/steveyegge/beads/releases/download/${{ steps.release.outputs.tag }}/checksums.txt" -o checksums.txt - - - name: Extract checksums - id: checksums - run: | - echo "darwin_amd64=$(grep 'darwin_amd64.tar.gz' checksums.txt | awk '{print $1}')" >> $GITHUB_OUTPUT - echo "darwin_arm64=$(grep 'darwin_arm64.tar.gz' checksums.txt | awk '{print $1}')" >> $GITHUB_OUTPUT - echo "linux_amd64=$(grep 'linux_amd64.tar.gz' checksums.txt | awk '{print $1}')" >> $GITHUB_OUTPUT - echo "linux_arm64=$(grep 'linux_arm64.tar.gz' checksums.txt | awk '{print $1}')" >> $GITHUB_OUTPUT - - - name: Update Homebrew formula - run: | - mkdir -p Formula - cat > Formula/bd.rb <<'EOF' - class Bd < Formula - desc "AI-supervised issue tracker for coding workflows" - homepage "https://github.com/steveyegge/beads" - version "${{ steps.release.outputs.version }}" - license "MIT" - - on_macos do - if Hardware::CPU.arm? - url "https://github.com/steveyegge/beads/releases/download/v#{version}/beads_#{version}_darwin_arm64.tar.gz" - sha256 "${{ steps.checksums.outputs.darwin_arm64 }}" - else - url "https://github.com/steveyegge/beads/releases/download/v#{version}/beads_#{version}_darwin_amd64.tar.gz" - sha256 "${{ steps.checksums.outputs.darwin_amd64 }}" - end - end - - on_linux do - if Hardware::CPU.arm? && Hardware::CPU.is_64_bit? - url "https://github.com/steveyegge/beads/releases/download/v#{version}/beads_#{version}_linux_arm64.tar.gz" - sha256 "${{ steps.checksums.outputs.linux_arm64 }}" - else - url "https://github.com/steveyegge/beads/releases/download/v#{version}/beads_#{version}_linux_amd64.tar.gz" - sha256 "${{ steps.checksums.outputs.linux_amd64 }}" - end - end - - def install - bin.install "bd" - end - - test do - system "#{bin}/bd", "version" - end - end - EOF - diff --git a/AGENT_INSTRUCTIONS.md b/AGENT_INSTRUCTIONS.md index 0f5015515..5c702fe84 100644 --- a/AGENT_INSTRUCTIONS.md +++ b/AGENT_INSTRUCTIONS.md @@ -381,7 +381,7 @@ This handles the entire release workflow automatically, including waiting ~5 min 4. Push version bump: `git push origin main` 5. Tag release: `git tag v && git push origin v` 6. Update Homebrew: `./scripts/update-homebrew.sh ` (waits for GitHub Actions) -7. Verify: `brew update && brew upgrade bd && bd version` +7. Verify: `brew update && brew upgrade beads && bd version` See [docs/RELEASING.md](docs/RELEASING.md) for complete manual instructions. diff --git a/RELEASING.md b/RELEASING.md index ef1b6d2a3..6a9af5971 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -422,7 +422,7 @@ tar -xzf beads_0.22.0_darwin_arm64.tar.gz ```bash brew update -brew upgrade bd +brew upgrade beads bd version ``` diff --git a/build-docs.md b/build-docs.md index 6cd735cda..6960ed45d 100644 --- a/build-docs.md +++ b/build-docs.md @@ -21,7 +21,7 @@ This infrastructure is critical for debugging, auditing, and user support - it a - `make install` - Used by developers building from source - `go install ./cmd/bd` - Direct Go installation with embedded ldflag injection - GitHub releases - Goreleaser-built binaries for all platforms - - Homebrew - Pre-built binaries installed via `brew install bd` + - Homebrew - Pre-built binaries installed via `brew install beads` - npm - Node.js package that downloads pre-built binaries via postinstall hook - `./scripts/install.sh` - User-friendly build-from-source helper diff --git a/claude-plugin/skills/beads/resources/TROUBLESHOOTING.md b/claude-plugin/skills/beads/resources/TROUBLESHOOTING.md index 03af6dc0a..f30ea5238 100644 --- a/claude-plugin/skills/beads/resources/TROUBLESHOOTING.md +++ b/claude-plugin/skills/beads/resources/TROUBLESHOOTING.md @@ -52,7 +52,7 @@ bd version **2. If version < 0.15.0, update bd:** ```bash # Via Homebrew (macOS/Linux) -brew upgrade bd +brew upgrade beads # Via go install go install github.com/steveyegge/beads/cmd/bd@latest diff --git a/docs/INSTALLING.md b/docs/INSTALLING.md index 87c7851c3..e9829f229 100644 --- a/docs/INSTALLING.md +++ b/docs/INSTALLING.md @@ -61,7 +61,7 @@ The installer will: | Method | Best For | Updates | Prerequisites | Notes | |--------|----------|---------|---------------|-------| -| **Homebrew** | macOS/Linux users | `brew upgrade bd` | Homebrew | Recommended. Handles everything automatically | +| **Homebrew** | macOS/Linux users | `brew upgrade beads` | Homebrew | Recommended. Handles everything automatically | | **npm** | JS/Node.js projects | `npm update -g @beads/bd` | Node.js | Convenient if npm is your ecosystem | | **bun** | JS/Bun.js projects | `bun install -g --trust @beads/bd` | Bun.js | Convenient if bun is your ecosystem | | **Install script** | Quick setup, CI/CD | Re-run script | curl, bash | Good for automation and one-liners | @@ -443,7 +443,7 @@ After installation: ### Homebrew ```bash -brew upgrade bd +brew upgrade beads ``` ### go install diff --git a/docs/RELEASING.md b/docs/RELEASING.md index 44a957f93..88aa59de9 100644 --- a/docs/RELEASING.md +++ b/docs/RELEASING.md @@ -190,7 +190,7 @@ The release will appear at: https://github.com/steveyegge/beads/releases 2. **Verify installations**: ```bash # Homebrew - brew update && brew upgrade bd && bd version + brew update && brew upgrade beads && bd version # PyPI pip install --upgrade beads-mcp diff --git a/scripts/README.md b/scripts/README.md index 71e59a50e..0ee67fa82 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -62,7 +62,7 @@ The script provides colorful, step-by-step progress output: After the script finishes: - GitHub Actions builds binaries for all platforms (~5 minutes) - PyPI package is published automatically -- Users can `brew upgrade bd` to get the new version +- Users can `brew upgrade beads` to get the new version - GitHub Release is created with binaries and changelog --- diff --git a/website/docs/getting-started/installation.md b/website/docs/getting-started/installation.md index dafbd2d72..ec08d4059 100644 --- a/website/docs/getting-started/installation.md +++ b/website/docs/getting-started/installation.md @@ -229,7 +229,7 @@ CGO_ENABLED=1 go install github.com/steveyegge/beads/cmd/bd@latest ### Homebrew ```bash -brew upgrade bd +brew upgrade beads ``` ### go install diff --git a/website/docs/getting-started/upgrading.md b/website/docs/getting-started/upgrading.md index abf9752fa..12b66ad62 100644 --- a/website/docs/getting-started/upgrading.md +++ b/website/docs/getting-started/upgrading.md @@ -24,7 +24,7 @@ bd info --whats-new --json # Machine-readable ### Homebrew ```bash -brew upgrade bd +brew upgrade beads ``` ### go install diff --git a/website/static/llms-full.txt b/website/static/llms-full.txt index fe82951e9..77e89dfea 100644 --- a/website/static/llms-full.txt +++ b/website/static/llms-full.txt @@ -363,7 +363,7 @@ The recommended approach for Claude Code, Cursor, Windsurf, and other editors wi ```bash # 1. Install bd CLI (see Quick Install above) -brew install bd +brew install beads # 2. Initialize in your project cd your-project @@ -449,7 +449,7 @@ CGO_ENABLED=1 go install github.com/steveyegge/beads/cmd/bd@latest ### Homebrew ```bash -brew upgrade bd +brew upgrade beads ``` ### go install @@ -646,7 +646,7 @@ bd info --whats-new --json # Machine-readable ### Homebrew ```bash -brew upgrade bd +brew upgrade beads ``` ### go install