Agent 推播設定

收件匣由 duckterm-hookd 驅動。從 App 複製對應平台的個人化指令，在 Agent 主機執行一次，即可完成安裝、一次配對、接上受支援的 Agent 並啟動服務。

開始之前

手機或平板已安裝 DuckTerm（Apple 裝置需 iOS / iPadOS 17+）
一台執行 Claude Code / Codex / Gemini CLI / 其他 Agent 的 macOS 或 Linux 機器
macOS 需安裝 Homebrew；Linux 需有 curl 與 systemd

1
複製個人化設定指令

開啟「設定 → Agent 通知」，選擇 macOS 或 Linux，然後長按程式碼區塊。複製出的版本已包含此 App 的配對 Token 與帳戶 ID。

從 DuckTerm 取得可直接執行的指令

網頁不會產生或顯示你的私人配對 Token。安裝或開啟 DuckTerm，然後到「設定 → Agent 通知」複製已填好的指令。

App Store

Google Play
2
在 Agent 執行處貼上一次

在該機器執行剛複製的指令。它會安裝 hookd、只配對一次、自動註冊受支援 Agent 的 Hook，並啟動背景服務，不需逐一設定。
下方範例使用預留位置。請從 App 複製個人化版本，其中已填入配對 Token 與帳戶 ID。
macOS
Homebrew · Apple 晶片與 Intel
brew install ducksee/tap/duckterm-hookd && \ "$(brew --prefix duckterm-hookd)/bin/duckterm-hookd" setup --token <pair-token> --user <account-id>
Linux
Ubuntu、Debian 等常見 systemd 發行版 · arm64 / x86_64
curl -fsSL https://raw.githubusercontent.com/ducksee/duckterm-hookd-releases/main/install.sh \ | DUCKTERM_PAIR_TOKEN=<pair-token> DUCKTERM_PAIR_USER=<account-id> sh
3
驗證

執行 `duckterm-hookd status`，再到「設定 → Agent 通知」分別測試本機推播與平台推播。日後升級 hookd 或重新啟動服務都會保留這次配對。
```
duckterm-hookd status
```
接著在「設定 → Agent 通知 → 驗證」分別傳送本機測試與平台推播測試。手機都能收到，就表示設定完成。

hookd 已安裝時的替代方式：掃描 QR Code 配對

如果 hookd 已經安裝完成，而且你偏好使用相機，可以執行下方指令取代 Token 配對指令，再用 App 掃描終端機裡的 QR Code。兩種配對方式擇一即可，請勿全部執行。日後升級或重新啟動服務會保留已儲存的配對。

duckterm-hookd pair --qr

會安裝哪些 Hook

hookd 已驗證 Claude Code、Codex、Grok Build、Antigravity、Cursor、OpenCode、Pi、Devin、Droid、Qoder、Amp 與 Gemini CLI 共 12 個工作流程。契約 v1 定義了 7 套決策模式，目前有 6 個已安裝轉接器能傳遞手機決策。OpenCode 目前僅回報生命週期狀態，其權限回覆轉接器仍待接入。Grok Build 使用自己的 hook 系統，並透過受支援的全域 hook 來源接入。