Agent 推送接入

Inbox 由 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 的备选方式：扫码配对

如果 hookd 已经安装好，并且你更想用相机，可以运行下方命令来替代 token 配对命令，再用 App 扫描终端二维码。两种配对方式任选其一，不要都运行。以后升级或重启服务会保留已保存的配对。

duckterm-hookd pair --qr

会挂接哪些 agent

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 来源接入。