From ab7447b9c923fd7624252ee4f8e762e4012bbdad Mon Sep 17 00:00:00 2001
From: Humberto Aquino <humberaquino@users.noreply.github.com>
Date: Mon, 21 Sep 2026 17:04:58 -0400
Subject: [PATCH 1/2] Add Homebrew tap release job

---
 .github/workflows/ci.yml | 27 +++++++++++++++++++++++++++
 README.md                | 11 ++++++++++-
 2 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 6e70047..61fb30b 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -124,3 +124,30 @@ jobs:
             exit 1
           fi
       - run: gh release create "v$VERSION" --title "v$VERSION" --notes-file notes.md --target "$GITHUB_SHA" dist/*.tar.xz
+
+  # Point the Homebrew tap (appcues/homebrew-tap) at the release just
+  # created. HOMEBREW_TAP_TOKEN is a fine-grained PAT with Contents
+  # read/write on that repo; the default token cannot push cross-repo.
+  homebrew:
+    needs: [version, release]
+    if: needs.version.outputs.release == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          repository: appcues/homebrew-tap
+          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+      - name: Bump formula
+        run: |
+          # release assets can lag a few seconds after the release is created
+          for i in 1 2 3 4 5; do
+            scripts/bump.sh appcues "${{ needs.version.outputs.version }}" && break
+            [ "$i" = 5 ] && exit 1
+            sleep 15
+          done
+      - name: Commit and push
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git commit -am "appcues ${{ needs.version.outputs.version }}"
+          git push
diff --git a/README.md b/README.md
index bdd63cc..ca0220b 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,16 @@ for agents that run on your machine (see "MCP server" below).
 
 ## Install
 
-Build from source (the only install path today):
+With Homebrew (macOS and Linux):
+
+```bash
+brew install appcues/tap/appcues
+```
+
+The formula lives in [appcues/homebrew-tap](https://github.com/appcues/homebrew-tap)
+and follows every release automatically. Upgrade with `brew upgrade appcues`.
+
+### From source
 
 ```bash
 git clone https://github.com/appcues/cli.git

From 6c866e04fc26c1246c30a6453f78fe13c63506ef Mon Sep 17 00:00:00 2001
From: Humberto Aquino <humberaquino@users.noreply.github.com>
Date: Mon, 21 Sep 2026 17:10:28 -0400
Subject: [PATCH 2/2] Drop the Homebrew release job; the tap is bumped by hand

---
 .github/workflows/ci.yml | 27 ---------------------------
 README.md                |  2 +-
 2 files changed, 1 insertion(+), 28 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 61fb30b..6e70047 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -124,30 +124,3 @@ jobs:
             exit 1
           fi
       - run: gh release create "v$VERSION" --title "v$VERSION" --notes-file notes.md --target "$GITHUB_SHA" dist/*.tar.xz
-
-  # Point the Homebrew tap (appcues/homebrew-tap) at the release just
-  # created. HOMEBREW_TAP_TOKEN is a fine-grained PAT with Contents
-  # read/write on that repo; the default token cannot push cross-repo.
-  homebrew:
-    needs: [version, release]
-    if: needs.version.outputs.release == 'true'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          repository: appcues/homebrew-tap
-          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
-      - name: Bump formula
-        run: |
-          # release assets can lag a few seconds after the release is created
-          for i in 1 2 3 4 5; do
-            scripts/bump.sh appcues "${{ needs.version.outputs.version }}" && break
-            [ "$i" = 5 ] && exit 1
-            sleep 15
-          done
-      - name: Commit and push
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git commit -am "appcues ${{ needs.version.outputs.version }}"
-          git push
diff --git a/README.md b/README.md
index ca0220b..976d2e6 100644
--- a/README.md
+++ b/README.md
@@ -32,7 +32,7 @@ brew install appcues/tap/appcues
 ```
 
 The formula lives in [appcues/homebrew-tap](https://github.com/appcues/homebrew-tap)
-and follows every release automatically. Upgrade with `brew upgrade appcues`.
+and is updated after each release. Upgrade with `brew upgrade appcues`.
 
 ### From source