feat(ci): add automatic Homebrew tap publishing

.github/workflows/release.yml

@@ -36,6 +36,13 @@ jobs:
       - name: Install syft (for SBOM generation)
         uses: anchore/sbom-action/download-syft@v0.22.2
 
+      - name: Get Homebrew tap token via dd-octo-sts
+        uses: DataDog/dd-octo-sts-action@acaa02eee7e3bb0839e4272dacb37b8f3b58ba80 # v1.0.3
+        id: octo-sts
+        with:
+          scope: DataDog/homebrew-pack
+          policy: pup-release
+
       - name: Run GoReleaser
         uses: goreleaser/goreleaser-action@v6
         with:
@@ -44,6 +51,7 @@ jobs:
           args: release --clean
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          HOMEBREW_TAP_TOKEN: ${{ steps.octo-sts.outputs.token }}
 
       - name: Upload release artifacts
         uses: actions/upload-artifact@v6

.goreleaser.yml

@@ -156,6 +156,34 @@ changelog:
     - title: "Other Changes"
       order: 999
 
+# Homebrew Tap
+brews:
+  - name: pup
+    repository:
+      owner: DataDog
+      name: homebrew-pack
+      token: "{{ .Env.HOMEBREW_TAP_TOKEN }}"
+    homepage: https://github.com/DataDog/pup
+    description: "Datadog API CLI - OAuth2 + API key authentication for Datadog APIs"
+    license: Apache-2.0
+    folder: Formula
+    commit_author:
+      name: goreleaserbot
+      email: bot@goreleaser.com
+    commit_msg_template: "chore(formula): update {{ .ProjectName }} to {{ .Tag }}"
+    install: |
+      bin.install "pup"
+    test: |
+      system "#{bin}/pup", "version"
+    dependencies:
+      - name: go
+        type: optional
+    extra_install: |
+      # Generate shell completions
+      bash_completion.install "completions/pup.bash" => "pup"
+      zsh_completion.install "completions/pup.zsh" => "_pup"
+      fish_completion.install "completions/pup.fish"
+
 # Announce releases
 announce:
   skip: false

CLAUDE.md

@@ -15,7 +15,11 @@ Go-based CLI wrapper for Datadog APIs. Provides OAuth2 + API key authentication
 ## Quick Start
 
 ```bash
-# Clone and build
+# Install via Homebrew (recommended)
+brew tap datadog/pack
+brew install pup
+
+# Or clone and build from source
 git clone https://github.com/DataDog/pup.git && cd pup
 go build -o pup .
 

README.md

@@ -157,10 +157,23 @@ See [docs/COMMANDS.md](docs/COMMANDS.md) for detailed command reference.
 
 ## Installation
 
+### Homebrew (macOS/Linux)
+
+```bash
+brew tap datadog/pack
+brew install pup
+```
+
+### Go Install
+
 ```bash
 go install github.com/DataDog/pup@latest
 ```
 
+### Manual Download
+
+Download pre-built binaries from the [latest release](https://github.com/DataDog/pup/releases/latest).
+
 ## Authentication
 
 Pup supports two authentication methods. **OAuth2 is preferred** and will be used automatically if you've logged in.