ci: verify the public Homebrew install path

.github/workflows/ci.yml

@@ -44,3 +44,20 @@ jobs:
             | grep arm64
           lipo -archs "/Applications/Agent Switch.app/Contents/MacOS/Agent Switch" \
             | grep x86_64
+
+  public-install:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: macos-14
+    steps:
+      - name: Run the public README install command
+        run: brew tap JNHFlow21/tap && brew trust --tap JNHFlow21/tap && brew install --cask JNHFlow21/tap/agent-switch
+
+      - name: Verify the public installation
+        run: |
+          agent-switch --version
+          test -d "/Applications/Agent Switch.app"
+          if xattr -p com.apple.quarantine "/Applications/Agent Switch.app"; then
+            echo "Gatekeeper quarantine was not removed" >&2
+            exit 1
+          fi
+          codesign --verify --deep --strict --verbose=2 "/Applications/Agent Switch.app"

README.md

@@ -20,6 +20,18 @@ This installs:
 - the `agent-switch` CLI and its bundled MCP server commands;
 - Homebrew-managed updates through the same Tap.
 
+Expected result:
+
+```bash
+agent-switch --version
+open -a "Agent Switch"
+```
+
+The CLI prints `agent-switch 0.2.0`, and the native app opens from
+`/Applications/Agent Switch.app`.
+
+## Security
+
 > [!WARNING]
 > Agent Switch is currently ad-hoc signed and not Apple-notarized. The primary
 > Alpha Cask deliberately removes Gatekeeper quarantine after installation.
@@ -49,7 +61,18 @@ MCP definitions and credentials.
 | `agent-switch` | Cask | Native macOS application |
 | `agent-switch-cli` | Formula | CLI backend required by the application |
 
-Issues belong in the [Agent Switch issue tracker][issues].
+## Documentation
+
+See the [Agent Switch README][source] for the first-run MCP and credential
+workflow.
+
+## Support
+
+Report reproducible problems in the [Agent Switch issue tracker][issues].
+
+## License
+
+[MIT](LICENSE) © 2026 JNHFlow21
 
 [source]: https://github.com/JNHFlow21/agent-switch
 [release]: https://github.com/JNHFlow21/agent-switch/releases/tag/v0.2.0

README.zh-CN.md

@@ -20,6 +20,18 @@ brew tap JNHFlow21/tap && brew trust --tap JNHFlow21/tap && brew install --cask
 - App 所需的 `agent-switch` CLI 和配套 MCP Server 命令；
 - 由同一个 Tap 管理的后续升级。
 
+预期结果：
+
+```bash
+agent-switch --version
+open -a "Agent Switch"
+```
+
+CLI 会输出 `agent-switch 0.2.0`，原生 App 会从
+`/Applications/Agent Switch.app` 打开。
+
+## 安全说明
+
 > [!WARNING]
 > Agent Switch 当前使用 ad-hoc 签名，尚未经过 Apple 公证。主要的 Alpha
 > Cask 会在安装完成后移除 Gatekeeper quarantine。安装前请先检查
@@ -47,7 +59,17 @@ brew uninstall agent-switch-cli
 | `agent-switch` | Cask | 原生 macOS App |
 | `agent-switch-cli` | Formula | App 运行所需的 CLI 后端 |
 
-问题请提交到 [Agent Switch Issues][issues]。
+## 文档
+
+首次运行、MCP 和凭据工作流见 [Agent Switch README][source]。
+
+## 支持
+
+可复现的问题请提交到 [Agent Switch Issues][issues]。
+
+## 许可证
+
+[MIT](LICENSE) © 2026 JNHFlow21
 
 [source]: https://github.com/JNHFlow21/agent-switch
 [release]: https://github.com/JNHFlow21/agent-switch/releases/tag/v0.2.0