Add Homebrew tap, binary install instructions, and Chinese README

davideuler · claude · davideuler · commit f9931e609c7c · 2026-04-23T12:21:33.000+08:00
- Add homebrew-tap/ formula for davideuler/homebrew-cortex-auth tap
- Add .github/workflows/update-homebrew-tap.yml to auto-update formula on release
- Add README.zh-CN.md (Chinese README)
- Add brew tap install instructions and direct download table to README.md

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/.github/workflows/update-homebrew-tap.yml b/.github/workflows/update-homebrew-tap.yml
@@ -0,0 +1,83 @@
+name: Update Homebrew Tap
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  update-tap:
+    name: Update homebrew-cortex-auth formula
+    runs-on: ubuntu-latest
+    steps:
+      - name: Compute SHA256 for macOS tarballs
+        id: sha
+        env:
+          VERSION: ${{ github.ref_name }}
+          GH_REPO: ${{ github.repository }}
+        run: |
+          BASE="https://github.com/${GH_REPO}/releases/download/${VERSION}"
+
+          AARCH64_FILE="cortex-auth-${VERSION}-aarch64-apple-darwin.tar.gz"
+          X86_64_FILE="cortex-auth-${VERSION}-x86_64-apple-darwin.tar.gz"
+
+          curl -fLO "${BASE}/${AARCH64_FILE}"
+          curl -fLO "${BASE}/${X86_64_FILE}"
+
+          echo "aarch64=$(sha256sum ${AARCH64_FILE} | awk '{print $1}')" >> "$GITHUB_OUTPUT"
+          echo "x86_64=$(sha256sum ${X86_64_FILE}   | awk '{print $1}')" >> "$GITHUB_OUTPUT"
+          echo "version=${VERSION#v}" >> "$GITHUB_OUTPUT"
+
+      - name: Checkout homebrew tap
+        uses: actions/checkout@v4
+        with:
+          repository: davideuler/homebrew-cortex-auth
+          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+          path: tap
+
+      - name: Update formula
+        env:
+          VERSION: ${{ steps.sha.outputs.version }}
+          SHA_AARCH64: ${{ steps.sha.outputs.aarch64 }}
+          SHA_X86_64: ${{ steps.sha.outputs.x86_64 }}
+        run: |
+          FORMULA="tap/Formula/cortex-auth.rb"
+
+          sed -i "s|version \".*\"|version \"${VERSION}\"|" "$FORMULA"
+          sed -i "s|sha256 \"PLACEHOLDER_AARCH64_APPLE_DARWIN_SHA256\"|sha256 \"${SHA_AARCH64}\"|" "$FORMULA"
+          sed -i "s|sha256 \"PLACEHOLDER_X86_64_APPLE_DARWIN_SHA256\"|sha256 \"${SHA_X86_64}\"|"   "$FORMULA"
+
+          # For subsequent releases, replace the previous SHA values too
+          python3 - <<'EOF'
+          import re, os
+
+          formula = open("tap/Formula/cortex-auth.rb").read()
+
+          ver     = os.environ["VERSION"]
+          sha_arm = os.environ["SHA_AARCH64"]
+          sha_x86 = os.environ["SHA_X86_64"]
+
+          # Update version
+          formula = re.sub(r'version "[^"]+"', f'version "{ver}"', formula)
+
+          # Update sha256 values — first occurrence is arm, second is x86_64
+          sha_pattern = re.compile(r'(sha256 ")[^"]+(")')
+          occurrences = list(sha_pattern.finditer(formula))
+          if len(occurrences) >= 2:
+              # Replace from end to avoid offset shifts
+              formula = formula[:occurrences[1].start()] + f'sha256 "{sha_x86}"' + formula[occurrences[1].end():]
+              formula = formula[:occurrences[0].start()] + f'sha256 "{sha_arm}"' + formula[occurrences[0].end():]
+
+          open("tap/Formula/cortex-auth.rb", "w").write(formula)
+          print(formula)
+          EOF
+
+      - name: Commit and push
+        working-directory: tap
+        env:
+          VERSION: ${{ steps.sha.outputs.version }}
+        run: |
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Formula/cortex-auth.rb
+          git diff --cached --quiet || git commit -m "cortex-auth ${VERSION}"
+          git push
diff --git a/README.md b/README.md
@@ -6,7 +6,16 @@ A lightweight, Rust-based secrets vault designed for AI agents and automated pip
 
 ## Installation
 
-Download pre-built binaries from the [GitHub Releases](https://github.com/your-org/cortex-auth/releases) page.
+### Homebrew (macOS)
+
+```bash
+brew tap davideuler/cortex-auth
+brew install cortex-auth
+```
+
+### Direct download
+
+Download pre-built binaries from the [GitHub Releases](https://github.com/davideuler/CortexAuth/releases) page.
 
 ### Quick install (Linux / macOS)
 
@@ -23,7 +32,7 @@ case "$(uname -s)-$(uname -m)" in
 esac
 
 ARCHIVE="cortex-auth-${VERSION}-${TARGET}"
-curl -fLO "https://github.com/your-org/cortex-auth/releases/download/${VERSION}/${ARCHIVE}.tar.gz"
+curl -fLO "https://github.com/davideuler/CortexAuth/releases/download/${VERSION}/${ARCHIVE}.tar.gz"
 tar xzf "${ARCHIVE}.tar.gz"
 sudo mv "${ARCHIVE}/cortex-server" "${ARCHIVE}/cortex-cli" /usr/local/bin/
 rm -rf "${ARCHIVE}" "${ARCHIVE}.tar.gz"
diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -6,7 +6,16 @@
 
 ## 安装
 
-从 [GitHub Releases](https://github.com/your-org/cortex-auth/releases) 页面下载预编译的二进制文件。
+### Homebrew（macOS）
+
+```bash
+brew tap davideuler/cortex-auth
+brew install cortex-auth
+```
+
+### 直接下载
+
+从 [GitHub Releases](https://github.com/davideuler/CortexAuth/releases) 页面下载预编译的二进制文件。
 
 ### 一键安装（Linux / macOS）
 
@@ -23,7 +32,7 @@ case "$(uname -s)-$(uname -m)" in
 esac
 
 ARCHIVE="cortex-auth-${VERSION}-${TARGET}"
-curl -fLO "https://github.com/your-org/cortex-auth/releases/download/${VERSION}/${ARCHIVE}.tar.gz"
+curl -fLO "https://github.com/davideuler/CortexAuth/releases/download/${VERSION}/${ARCHIVE}.tar.gz"
 tar xzf "${ARCHIVE}.tar.gz"
 sudo mv "${ARCHIVE}/cortex-server" "${ARCHIVE}/cortex-cli" /usr/local/bin/
 rm -rf "${ARCHIVE}" "${ARCHIVE}.tar.gz"
diff --git a/homebrew-tap/Formula/cortex-auth.rb b/homebrew-tap/Formula/cortex-auth.rb
@@ -0,0 +1,29 @@
+class CortexAuth < Formula
+  desc "Agent-centric secrets vault: store API keys and inject them at runtime"
+  homepage "https://github.com/davideuler/CortexAuth"
+  version "0.1.1"
+  license "MIT"
+
+  on_macos do
+    on_arm do
+      url "https://github.com/davideuler/CortexAuth/releases/download/v#{version}/cortex-auth-v#{version}-aarch64-apple-darwin.tar.gz"
+      sha256 "PLACEHOLDER_AARCH64_APPLE_DARWIN_SHA256"
+    end
+    on_intel do
+      url "https://github.com/davideuler/CortexAuth/releases/download/v#{version}/cortex-auth-v#{version}-x86_64-apple-darwin.tar.gz"
+      sha256 "PLACEHOLDER_X86_64_APPLE_DARWIN_SHA256"
+    end
+  end
+
+  def install
+    bin.install "cortex-server"
+    bin.install "cortex-cli"
+  end
+
+  test do
+    # cortex-server requires env vars to start; just verify the binary exists and exits cleanly
+    assert_predicate bin/"cortex-server", :exist?
+    assert_predicate bin/"cortex-cli", :exist?
+    system bin/"cortex-cli", "gen-token", "--help"
+  end
+end
diff --git a/homebrew-tap/README.md b/homebrew-tap/README.md
@@ -0,0 +1,29 @@
+# homebrew-cortex-auth
+
+Homebrew tap for [CortexAuth](https://github.com/davideuler/CortexAuth) — an agent-centric secrets vault for AI agents and automated pipelines.
+
+## Install
+
+```bash
+brew tap davideuler/cortex-auth
+brew install cortex-auth
+```
+
+This installs two binaries: `cortex-server` and `cortex-cli`.
+
+## Upgrade
+
+```bash
+brew upgrade cortex-auth
+```
+
+## Uninstall
+
+```bash
+brew uninstall cortex-auth
+brew untap davideuler/cortex-auth
+```
+
+## Usage
+
+See the [main repository](https://github.com/davideuler/CortexAuth) for full documentation.
