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

Cline 和 Aider 是人们最常放在后台运行的两个开源编程 agent,两者都能在有结果需要你查看时执行一条命令。它们本身不会往你的手机发任何东西,但改几行配置就能做到。
- Cline 在任务完成时运行一个钩子脚本,并支持 MCP,因此也可以自己写入内容并发出推送。
- Aider 在等待你输入时运行一条通知命令,包括每次回复之后,以及进行是或否确认之前。
两者都通过 Pocket Alert 发送,所以推送会和你其他服务的提醒一起出现在同一个应用里,历史记录也在一处。
准备工作
- 一个 Pocket Alert 账户,一个来自 API Keys 的 API 密钥,以及你的 iPhone 或 Android 手机上的应用。免费套餐就够用。
curl,以及 Cline 钩子需要的jq。
把密钥保存到文件里。在 macOS 上从 Dock 启动的编辑器不会读取你的 shell 配置文件,所以用文件存放是两个 agent 都能稳定读到的方式:
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 字段,但当前版本的扩展发送的是空值:
#!/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":""}'
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 服务器 发送推送。把它加入 Cline 的 MCP 设置文件 ~/.cline/data/settings/cline_mcp_settings.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 中添加一条指令:
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 正在处理的仓库。
#!/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,可以跳过脚本,直接把命令写进下面的配置中:
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 中添加:
notifications: true
notifications-command: ~/.config/pocketalert/aider-notify.sh
或者只在单次运行中使用:
aider --notifications --notifications-command ~/.config/pocketalert/aider-notify.sh
触发时机
Aider 每次模型回复后,会在它第一次等待你的时刻发送一条通知。通常是它完成编辑后出现的正常提示。如果它最先需要的是确认,比如 "Add file to the chat?" 或 "Run shell command?",推送就会针对这个确认发出,也就是"等待批准"的情况。同一轮交互中之后出现的其他确认不会再次发送推送。
Aider 不支持 MCP,因此通知命令是唯一的途径。它也已经足够:Aider 每次回复后都会等你,而这正是你希望得到提醒的时候。
手机上会收到什么
| Agent | 标题 | 正文 |
|---|---|---|
| Cline | Cline finished · api | Cline 结果的前 300 个字符 |
| 通过 MCP 的 Cline | agent 自己写的内容 | 它选择发送的摘要 |
| Aider | Aider is waiting · api | Your turn: reply or confirm in the terminal. |
消息默认是普通优先级。如果希望它们在 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 密钥,放入脚本,让 agent 在需要你时提醒你。