From e2ba5aed595f10348a7557ec8023423ab3769d43 Mon Sep 17 00:00:00 2001
From: JNHFlow21 <JNHFlow21@users.noreply.github.com>
Date: Thu, 23 Jul 2026 03:24:42 -0400
Subject: [PATCH 1/2] ci: verify the public Homebrew install path

---
 .github/workflows/ci.yml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 644746a..927e946 100644
--- a/.github/workflows/ci.yml
+++ b/.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"

From 84fd88f72f0b5878a4a022da8f4732313ec00f9d Mon Sep 17 00:00:00 2001
From: JNHFlow21 <JNHFlow21@users.noreply.github.com>
Date: Thu, 23 Jul 2026 03:25:36 -0400
Subject: [PATCH 2/2] docs: complete tap onboarding and support routes

---
 README.md       | 25 ++++++++++++++++++++++++-
 README.zh-CN.md | 24 +++++++++++++++++++++++-
 2 files changed, 47 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 1808512..f5d717f 100644
--- a/README.md
+++ b/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
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 397be47..bc78d4b 100644
--- a/README.zh-CN.md
+++ b/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