# Cline 和 Aider 推送通知：agent 等你时手机提醒你

> 为两个开源编程 agent 接入手机推送。Cline 使用 TaskComplete 钩子和 Pocket Alert MCP 服务器；Aider 只需在 .aider.conf.yml 中加一行。

*16.10.2026*

<!-- source: https://pocketalert.app/zh/blog/cline-aider-notifications -->

Cline 和 Aider 是人们最常放在后台运行的两个开源编程 agent，两者都能在有结果需要你查看时执行一条命令。它们本身不会往你的手机发任何东西，但改几行配置就能做到。

- **Cline** 在任务完成时运行一个钩子脚本，并支持 MCP，因此也可以自己写入内容并发出推送。
- **Aider** 在等待你输入时运行一条通知命令，包括每次回复之后，以及进行是或否确认之前。

两者都通过 Pocket Alert 发送，所以推送会和你其他服务的提醒一起出现在同一个应用里，历史记录也在一处。

## 准备工作

- 一个 Pocket Alert 账户，一个来自 [API Keys](/account/apikeys) 的 API 密钥，以及你的 [iPhone 或 Android](/get-app) 手机上的应用。免费套餐就够用。
- `curl`，以及 Cline 钩子需要的 `jq`。

把密钥保存到文件里。在 macOS 上从 Dock 启动的编辑器不会读取你的 shell 配置文件，所以用文件存放是两个 agent 都能稳定读到的方式：

```bash
mkdir -p ~/.config/pocketalert
printf '%s' 'YOUR_API_KEY' > ~/.config/pocketalert/key
chmod 600 ~/.config/pocketalert/key
```

## Cline

### 任务完成时的钩子

Cline 的钩子是以事件名命名的可执行文件。把一个名为 `TaskComplete`、没有扩展名的脚本放进 `~/Documents/Cline/Hooks/`，之后任何工作区里的任务结束时，Cline 都会运行它。如果只想用于某个项目，就改为在仓库中放置 `.clinerules/hooks/TaskComplete`。

脚本会从标准输入接收一个 JSON 对象。对于 `TaskComplete`，关键字段是 `taskComplete.taskMetadata.result`（Cline 的最终回答）和 `workspaceRoots`（已打开的文件夹）。还有一个 `initialTask` 字段，但当前版本的扩展发送的是空值：

```bash
#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.workspaceRoots[0] // "Cline"' <<<"$payload")")
result=$(jq -r '.taskComplete.taskMetadata.result // "" | if . == "" then "Done" else . end' <<<"$payload")

jq -n --arg t "Cline finished · $project" --arg m "${result:0:300}" \
  '{title: $t, message: $m}' |
  curl -sS --max-time 5 https://api.pocketalert.app/v1/messages \
    -H "Token: $(cat ~/.config/pocketalert/key)" \
    -H 'Content-Type: application/json' \
    --data-binary @- >/dev/null 2>&1 || true

echo '{"cancel":false,"contextModification":"","errorMessage":""}'
```

```bash
mkdir -p ~/Documents/Cline/Hooks
# save the script above as ~/Documents/Cline/Hooks/TaskComplete, then:
chmod +x ~/Documents/Cline/Hooks/TaskComplete
```

最后一行是 Cline 的钩子返回值：不取消、不修改上下文、不报错。钩子有 30 秒的时限，所以 curl 设置为 5 秒后放弃。

确认钩子已开启：Cline 功能设置中的 **Hooks** 开关默认是打开的。钩子在 macOS 和 Linux 上以 shell 脚本运行；在 Windows 上，Cline 需要一个名为 `TaskComplete.ps1` 的 PowerShell 脚本。

### "Cline 在等待批准"怎么办？

Cline 的钩子列表中有一个专门针对这种情况的 `Notification` 事件，但在当前 4.x 版本的扩展中，它已经定义却还没有被调用。在它生效之前，没有可靠的钩子能捕获批准提示：`PreToolUse` 会在每次工具调用前触发，包括自动批准的调用。如果你想离开电脑，比较实际的做法是为安全操作放宽 Cline 的自动批准设置，然后让 `TaskComplete` 在工作完成时通知你。

### MCP 服务器

Cline 是 MCP 客户端，因此也可以通过 [Pocket Alert MCP 服务器](/tools/mcp) 发送推送。把它加入 Cline 的 MCP 设置文件 `~/.cline/data/settings/cline_mcp_settings.json`：

```json
{
  "mcpServers": {
    "pocketalert": {
      "type": "streamableHttp",
      "url": "https://mcp.pocketalert.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" },
      "disabled": false,
      "autoApprove": ["create_message"]
    }
  }
}
```

请明确设置 `type`：如果不设置，Cline 会默认使用较旧的 SSE 传输方式，连接会失败。`autoApprove` 允许 Cline 不经询问直接发送推送，这正是你不在电脑前时需要的功能。较新版本的 Cline 会从 VS Code 扩展、CLI 和 JetBrains 中读取同一个文件。

然后在 `.clinerules` 中添加一条指令：

```text
When you finish a task that took more than a few minutes, call the pocketalert
create_message tool with a one-line summary. Use level "high" if something failed.
```

## Aider

Aider 内置了通知功能。使用 `--notifications` 时，它在等待输入时会显示桌面通知（或让终端响铃），而 `--notifications-command` 可以把这一行为替换成任何你想要的命令。手机推送只需要这些。

### 命令

Aider 会通过 shell 运行该命令，且不带参数，所以脚本需要根据自己能获取的信息构建消息：当前目录就是 Aider 正在处理的仓库。

```bash
#!/usr/bin/env bash
project=$(basename "$PWD")

curl -sS --max-time 5 https://api.pocketalert.app/v1/messages \
  -H "Token: $(cat ~/.config/pocketalert/key)" \
  -H 'Content-Type: application/json' \
  -d "{\"title\": \"Aider is waiting · $project\", \"message\": \"Your turn: reply or confirm in the terminal.\"}" \
  >/dev/null 2>&1 || true
```

将其保存为 `~/.config/pocketalert/aider-notify.sh`，然后执行 `chmod +x`。

如果你已安装并登录 2.0 或更高版本的 [Pocket Alert CLI](/tools/cli)，可以跳过脚本，直接把命令写进下面的配置中：

```yaml
notifications-command: 'pocketalert send -t "Aider is waiting · $(basename "$PWD")" -m "Your turn, reply or confirm in the terminal" -q'
```

外层的单引号可以防止 YAML 解析这一行的其余部分；Aider 会原样把它交给 shell。

### 开启

在 `~/.aider.conf.yml` 中添加两行，或在仓库里的 `.aider.conf.yml` 中添加：

```yaml
notifications: true
notifications-command: ~/.config/pocketalert/aider-notify.sh
```

或者只在单次运行中使用：

```bash
aider --notifications --notifications-command ~/.config/pocketalert/aider-notify.sh
```

### 触发时机

Aider 每次模型回复后，会在它第一次等待你的时刻发送一条通知。通常是它完成编辑后出现的正常提示。如果它最先需要的是确认，比如 "Add file to the chat?" 或 "Run shell command?"，推送就会针对这个确认发出，也就是"等待批准"的情况。同一轮交互中之后出现的其他确认不会再次发送推送。

Aider 不支持 MCP，因此通知命令是唯一的途径。它也已经足够：Aider 每次回复后都会等你，而这正是你希望得到提醒的时候。

## 手机上会收到什么

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Agent</th><th>标题</th><th>正文</th></tr></thead>
<tbody>
<tr><th>Cline</th><td>Cline finished · api</td><td>Cline 结果的前 300 个字符</td></tr>
<tr><th>通过 MCP 的 Cline</th><td>agent 自己写的内容</td><td>它选择发送的摘要</td></tr>
<tr><th>Aider</th><td>Aider is waiting · api</td><td>Your turn: reply or confirm in the terminal.</td></tr>
</tbody>
</table>
</div>

消息默认是普通优先级。如果希望它们在 iPhone 上穿透专注模式，就在 JSON 中加入 `"level": "high"`；如果希望保持安静，可以使用 `"low"`，回来后再去历史记录里查看。

## 如果没有收到推送

- **手动运行脚本。** 对于 Cline，执行 `echo '{}' | ~/Documents/Cline/Hooks/TaskComplete`；对于 Aider，执行 `~/.config/pocketalert/aider-notify.sh`。如果没有推送，问题出在密钥或网络上；删除 `>/dev/null 2>&1` 即可看到 curl 的返回结果。
- **检查文件名。** Cline 通过文件名匹配钩子：必须是完全相同的 `TaskComplete`，具有可执行权限，且没有 `.sh` 后缀。
- **检查 Aider 的配置键名。** 使用带连字符的 `notifications-command`，与 Aider 示例配置保持一致。

## 常见问题

### 两个 agent 都需要配置吗？

不需要。两部分配置相互独立，只设置你在用的那个即可。

### Cline 或 Aider 能看到我的 API 密钥吗？

钩子和通知命令从文件中读取密钥，不属于对话内容的一部分。MCP 配置中保存了密钥，以便 Cline 连接服务器；它不会被发送给模型。

### 我在电脑前时 Aider 会不会频繁打扰我？

它每次回复只发送一条推送。如果你坐在电脑前觉得太频繁，可以不加 `--notifications` 启动 Aider，只在长时间的会话中使用配置文件；或者在脚本开头加一个判断，例如 `[ -f ~/.aider-away ] || exit 0`，离开时创建该文件即可。

### 免费吗？

免费。Cline 和 Aider 都是开源的，Pocket Alert 的免费套餐在一台设备上每日可发送 50 条消息。

[获取 API 密钥](/signup)，放入脚本，让 agent 在需要你时提醒你。
