Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

feat: brew release

Luigi Agosti10ba846cf72a
diff --git a/.github/RELEASING.md b/.github/RELEASING.md
new file mode 100644
index 00000000..3e7329eb
--- /dev/null
+++ b/.github/RELEASING.md
@@ -0,0 +1,44 @@
+# Releasing PinchTab
+
+This is the release checklist for the GitHub tag-driven release pipeline.
+
+## One-time setup
+
+- Create the public tap repository `pinchtab/homebrew-tap`.
+- Add the `HOMEBREW_TAP_GITHUB_TOKEN` Actions secret to `pinchtab/pinchtab`.
+- The token must have write access to `pinchtab/homebrew-tap`.
+
+## What the release workflow does
+
+Pushing a tag like `v0.7.0` triggers [release.yml](/Users/luigi/dev/prj/giago/pt-bosch/.github/workflows/release.yml), which:
+
+1. Builds release binaries and creates the GitHub release via GoReleaser.
+2. Publishes the npm package.
+3. Builds and publishes container images.
+4. Generates a Homebrew formula PR against `pinchtab/homebrew-tap`.
+
+## Release steps
+
+1. Verify the branch you want to release is merged to `main`.
+2. Push the release tag:
+
+```bash
+git tag v0.7.0
+git push origin v0.7.0
+```
+
+3. Watch the `Release` workflow in GitHub Actions.
+4. Confirm GoReleaser opens a PR in `pinchtab/homebrew-tap`.
+5. Merge that PR.
+
+After the tap PR is merged, users can install with:
+
+```bash
+brew install pinchtab/tap/pinchtab
+```
+
+## Notes
+
+- The Homebrew formula is not published until the tap PR is merged.
+- No extra automation is required in `homebrew-tap` unless you want auto-merge.
+- The release workflow can also be run manually with `workflow_dispatch` and a tag input.
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index d2cef6de..aa231d1b 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -7,11 +7,13 @@ name: Release
# 2. Build Go binary + create GitHub release (goreleaser)
# 3. Publish npm package (with postinstall binary download support)
# 4. Build & push Docker images
+# See .github/RELEASING.md for the operational checklist.
#
# Secrets required:
# - NPM_TOKEN: npm authentication (https://docs.npmjs.com/creating-and-viewing-access-tokens)
# - DOCKERHUB_USER / DOCKERHUB_TOKEN: Docker Hub credentials
# - GITHUB_TOKEN: Automatic (GitHub Actions)
+# - HOMEBREW_TAP_GITHUB_TOKEN: PAT with write access to pinchtab/homebrew-tap
#
# To create a release:
# git tag v0.7.0
@@ -68,6 +70,7 @@ jobs:
args: release --clean
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ HOMEBREW_TAP_GITHUB_TOKEN: ${{ secrets.HOMEBREW_TAP_GITHUB_TOKEN }}
npm:
name: Publish to npm
diff --git a/.goreleaser.yml b/.goreleaser.yml
index ad06cbaf..ca9c9469 100644
--- a/.goreleaser.yml
+++ b/.goreleaser.yml
@@ -25,6 +25,28 @@ archives:
checksum:
name_template: checksums.txt
+brews:
+ - name: pinchtab
+ repository:
+ owner: pinchtab
+ name: homebrew-tap
+ branch: "brew-{{ .ProjectName }}-{{ .Version }}"
+ token: "{{ .Env.HOMEBREW_TAP_GITHUB_TOKEN }}"
+ pull_request:
+ enabled: true
+ base:
+ owner: pinchtab
+ name: homebrew-tap
+ branch: main
+ directory: Formula
+ homepage: "https://pinchtab.com"
+ description: "High-performance browser automation bridge and multi-instance orchestrator for AI agents"
+ license: "MIT"
+ test: |
+ system "#{bin}/pinchtab version"
+ install: |
+ bin.install "pinchtab"
+
changelog:
sort: asc
filters:
diff --git a/README.md b/README.md
index 7fa0567a..312cc067 100644
--- a/README.md
+++ b/README.md
@@ -155,6 +155,11 @@ Most users should not need to think about `pinchtab bridge` directly, and only n
curl -fsSL https://pinchtab.com/install.sh | bash
```
+**Homebrew (macOS / Linux):**
+```bash
+brew install pinchtab/tap/pinchtab
+```
+
**npm:**
```bash
npm install -g pinchtab