chore(homebrew): add cask, docs, and release automation

Author: 李杰

.github/workflows/release.yml

@@ -91,3 +91,77 @@ jobs:
           releaseDraft: false
           prerelease: false
           args: ${{ matrix.args }}
+
+  update-homebrew-cask:
+    name: Update Homebrew Cask
+    needs: release
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      # Update the cask on main, not on the tag ref.
+      - name: Checkout main
+        uses: actions/checkout@v4
+        with:
+          ref: main
+
+      - name: Determine version
+        shell: bash
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          echo "VERSION=$VERSION" >> "$GITHUB_ENV"
+
+      - name: Download universal DMG from GitHub Releases (retry)
+        shell: bash
+        run: |
+          set -euo pipefail
+          URL="https://github.com/${GITHUB_REPOSITORY}/releases/download/v${VERSION}/Cockpit.Tools_${VERSION}_universal.dmg"
+          echo "Downloading: $URL"
+          for i in $(seq 1 30); do
+            if curl -fL --retry 3 --retry-delay 1 -o cockpit-tools.dmg "$URL"; then
+              exit 0
+            fi
+            echo "Asset not ready yet (attempt $i/30). Sleeping 10s..."
+            sleep 10
+          done
+          echo "Failed to download release asset after retries."
+          exit 1
+
+      - name: Compute sha256
+        shell: bash
+        run: |
+          set -euo pipefail
+          SHA256="$(sha256sum cockpit-tools.dmg | awk '{print $1}')"
+          echo "SHA256=$SHA256" >> "$GITHUB_ENV"
+
+      - name: Update Cask file
+        shell: bash
+        run: |
+          set -euo pipefail
+          FILE="Casks/cockpit-tools.rb"
+          if [ ! -f "$FILE" ]; then
+            echo "Missing $FILE. Create it first."
+            exit 1
+          fi
+
+          perl -0777 -i -pe \
+            's/version \"[^\"]+\"/version \"'"$VERSION"'\"/; s/sha256 \"[0-9a-f]{64}\"/sha256 \"'"$SHA256"'\"/' \
+            "$FILE"
+
+          git diff -- "$FILE"
+
+      - name: Create pull request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          commit-message: "chore(homebrew): update cask for v${{ env.VERSION }}"
+          title: "chore(homebrew): update cask for v${{ env.VERSION }}"
+          body: |
+            Auto-generated by the release workflow.
+
+            - version: ${{ env.VERSION }}
+            - sha256 (universal.dmg): ${{ env.SHA256 }}
+          branch: "automation/update-cask-v${{ env.VERSION }}"
+          base: main
+          delete-branch: true

Casks/cockpit-tools.rb

@@ -0,0 +1,30 @@
+cask "cockpit-tools" do
+  version "0.5.4"
+  sha256 "8f07029f6d5611dd272ddba7309cd7afb9a3c45842f4bd4728c01f6067d16c62"
+
+  url "https://github.com/jlcodes99/cockpit-tools/releases/download/v#{version}/Cockpit.Tools_#{version}_universal.dmg",
+      verified: "github.com/jlcodes99/cockpit-tools/"
+  name "Cockpit Tools"
+  desc "Account manager for AI IDEs (Antigravity and Codex)"
+  homepage "https://github.com/jlcodes99/cockpit-tools"
+
+  auto_updates true
+
+  app "Cockpit Tools.app"
+
+  zap trash: [
+    "~/Library/Application Support/com.jlcodes.cockpit-tools",
+    "~/Library/Caches/com.jlcodes.cockpit-tools",
+    "~/Library/Preferences/com.jlcodes.cockpit-tools.plist",
+    "~/Library/Saved Application State/com.jlcodes.cockpit-tools.savedState",
+  ]
+
+  caveats <<~EOS
+    If you encounter the "App is damaged" error, please run:
+      sudo xattr -rd com.apple.quarantine "/Applications/Cockpit Tools.app"
+
+    Or install with the --no-quarantine flag:
+      brew install --cask --no-quarantine cockpit-tools
+  EOS
+end
+

README.en.md

@@ -94,6 +94,21 @@ Go to [GitHub Releases](https://github.com/jlcodes99/cockpit-tools/releases) to
 *   **Windows**: `.msi` (Recommended) or `.exe`
 *   **Linux**: `.deb` (Debian/Ubuntu) or `.AppImage` (Universal)
 
+### Option B: Install with Homebrew (macOS)
+
+> Homebrew is required.
+
+```bash
+brew tap jlcodes99/cockpit-tools https://github.com/jlcodes99/cockpit-tools
+brew install --cask cockpit-tools
+```
+
+If you hit the macOS "App is damaged" warning, you can also install with `--no-quarantine`:
+
+```bash
+brew install --cask --no-quarantine cockpit-tools
+```
+
 ### 🛠️ Troubleshooting
 
 #### macOS says "App is damaged and can't be opened"?

README.md

@@ -91,6 +91,21 @@ Codex 同样支持多账号多实例并行运行。比如同时打开两个 Code
 *   **Windows**: `.msi` (推荐) 或 `.exe`
 *   **Linux**: `.deb` (Debian/Ubuntu) 或 `.AppImage` (通用)
 
+### 选项 B: Homebrew 安装 (macOS)
+
+> 需要先安装 Homebrew。
+
+```bash
+brew tap jlcodes99/cockpit-tools https://github.com/jlcodes99/cockpit-tools
+brew install --cask cockpit-tools
+```
+
+如果遇到 macOS “应用已损坏”或无法打开，也可以使用 `--no-quarantine` 安装：
+
+```bash
+brew install --cask --no-quarantine cockpit-tools
+```
+
 ### 🛠️ 常见问题排查 (Troubleshooting)
 
 #### macOS 提示“应用已损坏，无法打开”？