feat(action): add composite GitHub Action to install gddy CLI

.github/workflows/action-test.yml

@@ -0,0 +1,65 @@
+name: Test setup-gddy action
+
+# Exercises action/action.yml itself against real GitHub Releases, on all
+# three OSes the CLI ships for. Path-filtered so it doesn't run on unrelated
+# CLI-only PRs — see the "action" release-please package in
+# release-please-config.json for why this is versioned separately from gddy.
+
+on:
+  pull_request:
+    paths:
+      - "action/**"
+      - ".github/workflows/action-test.yml"
+  push:
+    branches: [main]
+    paths:
+      - "action/**"
+
+jobs:
+  latest:
+    name: Install latest (${{ matrix.os }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+
+      - name: Run action
+        id: gddy
+        uses: ./action
+
+      - name: Verify gddy is installed and on PATH
+        shell: bash
+        run: |
+          gddy --version
+          test -n "${{ steps.gddy.outputs.version }}"
+          test -n "${{ steps.gddy.outputs.path }}"
+
+  pinned-version:
+    name: Install pinned version (${{ matrix.os }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+
+      - name: Run action
+        id: gddy
+        uses: ./action
+        with:
+          version: v0.2.23
+
+      - name: Verify pinned version was installed
+        shell: bash
+        run: |
+          gddy --version
+          case "${{ steps.gddy.outputs.version }}" in
+            *0.2.23*) ;;
+            *) echo "expected v0.2.23, got '${{ steps.gddy.outputs.version }}'" >&2; exit 1 ;;
+          esac

.github/workflows/release.yml

@@ -29,8 +29,10 @@ jobs:
     name: Release Please
     runs-on: ubuntu-latest
     outputs:
-      releases_created: ${{ steps.release.outputs.releases_created }}
+      rust_release_created: ${{ steps.release.outputs['rust--release_created'] }}
       tag_name: ${{ steps.release.outputs['rust--tag_name'] }}
+      action_release_created: ${{ steps.release.outputs['action--release_created'] }}
+      action_tag_name: ${{ steps.release.outputs['action--tag_name'] }}
     steps:
       - uses: googleapis/release-please-action@45996ed1f6d02564a971a2fa1b5860e934307cf7 #v5.0.0
         id: release
@@ -40,10 +42,38 @@ jobs:
           manifest-file: .release-please-manifest.json
           target-branch: main
 
+  action-release:
+    name: Finalize action release
+    needs: release-please
+    if: needs.release-please.outputs.action_release_created == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          fetch-depth: 0
+
+      # This release has no binaries attached — it must never become the
+      # repo's "latest" release, or the CLI's own
+      # `releases/latest/download/install.sh` one-liner 404s.
+      - name: Keep gddy as the repo's "latest" release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release edit "${{ needs.release-please.outputs.action_tag_name }}" --latest=false
+
+      - name: Move floating major tag
+        run: |
+          TAG="${{ needs.release-please.outputs.action_tag_name }}"
+          MAJOR="action-v$(echo "$TAG" | sed -E 's/^action-v([0-9]+)\..*/\1/')"
+          git tag -f "$MAJOR" "$TAG"
+          git push origin "$MAJOR" --force
+
   build:
     name: Build ${{ matrix.target }}
     needs: release-please
-    if: needs.release-please.outputs.releases_created == 'true' || (github.event_name == 'workflow_dispatch' && inputs.publish_only == true)
+    if: needs.release-please.outputs.rust_release_created == 'true' || (github.event_name == 'workflow_dispatch' && inputs.publish_only == true)
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
@@ -268,8 +298,8 @@ jobs:
             dist/gddy-*.tar.gz \
             dist/gddy-*.zip \
             dist/gddy-checksums-sha256.txt \
-            install.sh \
-            install.ps1 \
+            action/install.sh \
+            action/install.ps1 \
             --clobber
           # Publish only now assets are complete; stays a draft if build fails.
           gh release edit "$TAG" --draft=false --latest

.github/workflows/rust-port-alpha.yaml

@@ -6,7 +6,7 @@ name: main alpha
 # prerelease on the fixed `alpha` tag, overwritten on each push.
 #
 # This repo is PUBLIC, so the install flow uses plain `curl` against the public
-# release assets — no `gh` or auth required (see install.sh).
+# release assets — no `gh` or auth required (see action/install.sh).
 
 on:
   push:
@@ -198,5 +198,5 @@ jobs:
             dist/gddy-aarch64-apple-darwin.tar.gz \
             dist/gddy-x86_64-pc-windows-msvc.zip \
             dist/gddy-checksums-sha256.txt \
-            install.sh \
-            install.ps1
+            action/install.sh \
+            action/install.ps1

.release-please-manifest.json

@@ -1,3 +1,4 @@
 {
+  "action": "1.0.0",
   "rust": "0.2.24"
 }

README.md

@@ -22,6 +22,17 @@ Both installers download, checksum-verify, and install the binary for your platf
 
 Once installed, `gddy update check` / `gddy update apply` handles upgrades in place.
 
+### GitHub Actions
+
+Use [`godaddy/cli/action`](action/action.yml) to install `gddy` inside a workflow:
+
+```yaml
+- uses: godaddy/cli/action@action-v1
+- run: gddy --version
+```
+
+Pin an exact `gddy` release with `with: { version: v0.2.23 }`; omit it for latest. The action is versioned independently of the CLI itself — `action-v1` always points at the latest `action-v1.x.y` release.
+
 ### Agentic Skills
 
 To install Claude Code skills for the `gddy` CLI, run the following:

action/action.yml

@@ -0,0 +1,75 @@
+name: Setup gddy CLI
+description: >
+  Install the GoDaddy CLI (gddy) from GitHub Releases and add it to PATH
+author: GoDaddy
+branding:
+  icon: download-cloud
+  color: green
+
+inputs:
+  version:
+    description: >
+      gddy release to install, e.g. "v0.2.23". Defaults to the latest release.
+    required: false
+    default: latest
+
+outputs:
+  version:
+    description: >
+      The gddy version that was installed (as reported by `gddy --version`)
+    value: >
+      ${{ steps.install-unix.outputs.version || steps.install-windows.outputs.version }}
+  path:
+    description: Directory the gddy binary was installed to
+    value: >
+      ${{ steps.install-unix.outputs.path || steps.install-windows.outputs.path }}
+
+runs:
+  using: composite
+  steps:
+    - name: Install gddy (Linux/macOS)
+      id: install-unix
+      if: runner.os != 'Windows'
+      shell: bash
+      env:
+        GDDY_VERSION: ${{ inputs.version }}
+      run: |
+        set -euo pipefail
+        prefix="${RUNNER_TEMP}/gddy-bin"
+        mkdir -p "$prefix"
+
+        args=(--prefix "$prefix")
+        if [ "$GDDY_VERSION" != "latest" ]; then
+          args+=(--version "$GDDY_VERSION")
+        fi
+
+        bash "${{ github.action_path }}/install.sh" "${args[@]}"
+
+        echo "$prefix" >> "$GITHUB_PATH"
+        {
+          echo "path=$prefix"
+          echo "version=$("$prefix/gddy" --version)"
+        } >> "$GITHUB_OUTPUT"
+
+    - name: Install gddy (Windows)
+      id: install-windows
+      if: runner.os == 'Windows'
+      shell: pwsh
+      env:
+        GDDY_VERSION: ${{ inputs.version }}
+      run: |
+        $prefix = Join-Path $env:RUNNER_TEMP 'gddy-bin'
+        New-Item -ItemType Directory -Path $prefix -Force | Out-Null
+
+        $scriptArgs = @{ Prefix = $prefix; SkipPathUpdate = $true }
+        if ($env:GDDY_VERSION -ne 'latest') {
+          $scriptArgs['Version'] = $env:GDDY_VERSION
+        }
+
+        & "${{ github.action_path }}\install.ps1" @scriptArgs
+
+        $installedVersion = & "$prefix\gddy.exe" --version
+
+        Add-Content -Path $env:GITHUB_PATH -Value $prefix
+        Add-Content -Path $env:GITHUB_OUTPUT -Value "path=$prefix"
+        Add-Content -Path $env:GITHUB_OUTPUT -Value "version=$installedVersion"

install.ps1 → action/install.ps1

@@ -23,7 +23,12 @@
 [CmdletBinding()]
 param(
     [string]$Prefix,
-    [string]$Version
+    [string]$Version,
+    # Skips the persistent (registry) user PATH update below, only setting
+    # PATH for the current session. Intended for callers (e.g. the
+    # accompanying GitHub Action) that manage PATH themselves and don't want
+    # this install to leave a stale entry behind on long-lived machines.
+    [switch]$SkipPathUpdate
 )
 
 Set-StrictMode -Version Latest
@@ -132,16 +137,21 @@ try {
 
     # ── 4. PATH ──────────────────────────────────────────────────────────────
 
-    $userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
-    # Wrap in @(...): Windows PowerShell 5.1 (unlike pwsh 7+) doesn't add an
-    # auto Count property to a bare $null/single-string pipeline result, so
-    # this throws under Set-StrictMode when there are 0 or 1 matches.
-    $onPath = @($userPath -split ';' | Where-Object { $_.TrimEnd('\') -ieq $Prefix.TrimEnd('\') }).Count -gt 0
-    if (-not $onPath) {
-        $newPath = if ([string]::IsNullOrEmpty($userPath)) { $Prefix } else { "$userPath;$Prefix" }
-        [Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
-        $env:Path = "$env:Path;$Prefix"  # current session
-        Write-Info "Added $Prefix to your user PATH (restart your shell for new shells to see it)."
+    if ($SkipPathUpdate) {
+        $env:Path = "$env:Path;$Prefix"  # current session only
+        Write-Info "Skipping persistent user PATH update for $Prefix (caller manages PATH)."
+    } else {
+        $userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
+        # Wrap in @(...): Windows PowerShell 5.1 (unlike pwsh 7+) doesn't add an
+        # auto Count property to a bare $null/single-string pipeline result, so
+        # this throws under Set-StrictMode when there are 0 or 1 matches.
+        $onPath = @($userPath -split ';' | Where-Object { $_.TrimEnd('\') -ieq $Prefix.TrimEnd('\') }).Count -gt 0
+        if (-not $onPath) {
+            $newPath = if ([string]::IsNullOrEmpty($userPath)) { $Prefix } else { "$userPath;$Prefix" }
+            [Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
+            $env:Path = "$env:Path;$Prefix"  # current session
+            Write-Info "Added $Prefix to your user PATH (restart your shell for new shells to see it)."
+        }
     }
 } finally {
     Remove-Item -Recurse -Force -LiteralPath $work -ErrorAction SilentlyContinue

release-please-config.json

@@ -2,6 +2,7 @@
   "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
   "bump-minor-pre-major": true,
   "bump-patch-for-minor-pre-major": true,
+  "separate-pull-requests": true,
   "changelog-sections": [
     { "type": "feat", "section": "Features" },
     { "type": "fix", "section": "Bug Fixes" },
@@ -22,6 +23,12 @@
       "include-component-in-tag": false,
       "draft": true,
       "force-tag-creation": true
+    },
+    "action": {
+      "release-type": "simple",
+      "component": "action",
+      "include-component-in-tag": true,
+      "draft": false
     }
   }
 }