Add release automation and installation methods

.github/workflows/release.yml

@@ -0,0 +1,47 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+
+      - name: Set up Go module cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cache/go-build
+            ~/go/pkg/mod
+          key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
+          restore-keys: |
+            ${{ runner.os }}-go-
+
+      - name: Install GoReleaser
+        uses: goreleaser/goreleaser-action@v6
+        with:
+          version: latest
+          distribution: goreleaser
+          install-only: true
+
+      - name: Run GoReleaser
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          HOMEBREW_TAP_GITHUB_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+        run: goreleaser release --clean

.goreleaser.yaml

@@ -0,0 +1,53 @@
+version: 2
+project_name: devx
+before:
+  hooks:
+    - go test ./...
+
+builds:
+  - id: devx
+    main: ./main.go
+    binary: devx
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - darwin
+      - linux
+    goarch:
+      - amd64
+      - arm64
+    ldflags:
+      - -s -w
+      - -X github.com/jfox85/devx/version.Version={{.Version}}
+      - -X github.com/jfox85/devx/version.GitCommit={{.ShortCommit}}
+      - -X github.com/jfox85/devx/version.BuildDate={{.Date}}
+
+archives:
+  - name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+    files:
+      - LICENSE
+      - README.md
+    wrap_in_directory: false
+
+changelog:
+  use: git
+
+brews:
+  - name: devx
+    homepage: https://github.com/jfox85/devx
+    description: "A macOS development environment manager"
+    license: "MIT"
+    commit_author:
+      name: devx-bot
+      email: devx@jonefox.com
+    repository:
+      owner: jfox85
+      name: homebrew-devx
+      token: "{{ .Env.HOMEBREW_TAP_GITHUB_TOKEN }}"
+    test: |
+      system "#{bin}/devx", "--version"
+    install: |
+      bin.install "devx"
+
+announce:
+  skip: true

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 jfox85
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -33,6 +33,39 @@ A macOS CLI tool for managing local development environments with Git worktrees,
 
 ## Installation
 
+### Homebrew (macOS & Linux)
+
+```bash
+brew tap jfox85/homebrew-devx
+brew install devx
+```
+
+### go install (requires Go 1.22+)
+
+```bash
+go install github.com/jfox85/devx@latest
+```
+
+### Universal install script
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/jfox85/devx/main/install/install.sh | bash
+```
+
+Set `DEVX_INSTALL_DIR` or `DEVX_VERSION` to customize the installation:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/jfox85/devx/main/install/install.sh \
+  | DEVX_INSTALL_DIR=$HOME/.local/bin DEVX_VERSION=v1.2.3 bash
+```
+
+### Direct binary download
+
+Download the appropriate archive from the [releases page](https://github.com/jfox85/devx/releases), extract it, and move the
+`devx` binary into your `PATH`.
+
+### Build from source
+
 ```bash
 git clone https://github.com/jfox85/devx
 cd devx
@@ -41,7 +74,7 @@ make build
 mv devx /usr/local/bin/
 ```
 
-**Alternative installation methods:**
+**Alternative build targets:**
 ```bash
 # Development build (no version info)
 make dev

install/install-redirect.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="refresh" content="0;url=https://raw.githubusercontent.com/jfox85/devx/main/install/install.sh" />
+    <title>Install devx</title>
+  </head>
+  <body>
+    <p>
+      Redirecting to the latest install script. If you are not automatically redirected,
+      <a href="https://raw.githubusercontent.com/jfox85/devx/main/install/install.sh">click here</a>.
+    </p>
+  </body>
+</html>

install/install.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO="jfox85/devx"
+INSTALL_DIR="${DEVX_INSTALL_DIR:-/usr/local/bin}"
+VERSION="${DEVX_VERSION:-latest}"
+
+usage() {
+  cat <<USAGE
+Install devx from GitHub releases.
+
+Environment variables:
+  DEVX_VERSION       Specific version (defaults to latest release)
+  DEVX_INSTALL_DIR   Target directory for the devx binary (default: /usr/local/bin)
+USAGE
+}
+
+command -v curl >/dev/null 2>&1 || { echo "curl is required to install devx" >&2; exit 1; }
+command -v tar >/dev/null 2>&1 || { echo "tar is required to install devx" >&2; exit 1; }
+
+if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
+  usage
+  exit 0
+fi
+
+os="$(uname -s | tr '[:upper:]' '[:lower:]')"
+arch="$(uname -m)"
+
+case "$os" in
+  linux|darwin)
+    ;;
+  *)
+    echo "Unsupported operating system: $os" >&2
+    exit 1
+    ;;
+esac
+
+case "$arch" in
+  x86_64|amd64)
+    arch="amd64"
+    ;;
+  arm64|aarch64)
+    arch="arm64"
+    ;;
+  *)
+    echo "Unsupported architecture: $arch" >&2
+    exit 1
+    ;;
+esac
+
+if [[ "$VERSION" == "latest" ]]; then
+  VERSION="$(curl -fsSL "https://api.github.com/repos/${REPO}/releases/latest" | \
+    grep -m1 '"tag_name"' | sed -E 's/.*"([^"]+)".*/\1/')"
+  if [[ -z "$VERSION" ]]; then
+    echo "Unable to determine latest release version" >&2
+    exit 1
+  fi
+else
+  if [[ "$VERSION" != v* ]]; then
+    VERSION="v${VERSION}"
+  fi
+fi
+
+asset_version="${VERSION#v}"
+asset="devx_${asset_version}_${os}_${arch}.tar.gz"
+url="https://github.com/${REPO}/releases/download/${VERSION}/${asset}"
+
+workdir="$(mktemp -d)"
+trap 'rm -rf "$workdir"' EXIT
+
+echo "Downloading ${asset}..."
+curl -fsSL "${url}" -o "${workdir}/${asset}"
+
+echo "Extracting devx..."
+tar -xzf "${workdir}/${asset}" -C "${workdir}"
+
+mkdir -p "${INSTALL_DIR}"
+install -m 0755 "${workdir}/devx" "${INSTALL_DIR}/devx"
+
+echo "devx installed to ${INSTALL_DIR}/devx"
+"${INSTALL_DIR}/devx" --version || true