返回博客

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

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标题正文
ClineCline finished · apiCline 结果的前 300 个字符
通过 MCP 的 Clineagent 自己写的内容它选择发送的摘要
AiderAider is waiting · apiYour 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 在需要你时提醒你。

分享这篇文章