Назад в блог

Push-уведомления для Cline и Aider: узнавайте, когда очередь за вами

Push-уведомления для Cline и Aider: узнавайте, когда очередь за вами

Cline и Aider — два открытых агента для программирования, которые чаще всего оставляют работать в фоне. Оба умеют запускать команду, когда есть что посмотреть. Ни один из них сам по себе не отправляет ничего на телефон. Это меняют несколько строк конфигурации.

  • Cline запускает скрипт-хук, когда задача завершена, и говорит по MCP, поэтому может отправлять push-уведомления и сам.
  • Aider запускает команду уведомления, когда ждёт вашего ответа: после ответа модели или перед подтверждением «да/нет».

Оба отправляют через Pocket Alert, поэтому push-уведомления попадают в то же приложение и в ту же историю, что и оповещения от всего остального, что вы запускаете.

Что понадобится

  • Аккаунт Pocket Alert, API-ключ из раздела API Keys и приложение на вашем iPhone или Android телефоне. Бесплатного тарифа достаточно.
  • curl, а для хука Cline ещё jq.

Сохраните ключ в файл. Редакторы, запущенные из Dock на macOS, не читают ваш профиль shell, поэтому файл — единственное место, которое оба агента всегда найдут:

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 в репозитории.

Скрипт получает на stdin 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 прекращает попытку через пять.

Убедитесь, что хуки включены: переключатель Hooks в настройках функций Cline включён по умолчанию. На macOS и Linux хуки работают как shell-скрипты; в Windows Cline ожидает PowerShell-скрипт с именем TaskComplete.ps1.

А что насчёт «Cline ждёт подтверждения»?

В списке хуков Cline есть событие Notification именно для этого, но в текущем расширении 4.x оно объявлено и пока не вызывается. Пока этого не произойдёт, надёжного хука для запросов на подтверждение нет: PreToolUse срабатывает перед каждым инструментом, в том числе автоподтверждаемыми. Если хотите отойти от компьютера, на практике проще расширить автоподтверждение в настройках Cline для безопасных действий и позволить TaskComplete сообщить, когда работа закончена.

MCP-сервер

Cline — MCP-клиент, поэтому может отправлять push-уведомления и через MCP-сервер Pocket Alert. Добавьте его в файл настроек MCP Cline, ~/.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 отправить push-уведомление без вашего подтверждения, а это и нужно, когда вы вне компьютера. Новые версии 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 заменяет это любой командой. Для push-уведомления на телефон больше ничего не нужно.

Команда

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.

Если установлен и авторизован CLI Pocket Alert версии 2.0 или новее, можно обойтись без скрипта и вписать команду прямо в конфиг ниже:

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?», push придёт именно по нему — это и есть случай «ждёт подтверждения». Дальнейшие подтверждения в том же обмене новых push-уведомлений не вызывают.

У Aider нет поддержки MCP, поэтому единственный путь — команда уведомления. Её и достаточно: Aider ждёт вас после каждого ответа, и именно тогда вам стоит знать.

Что приходит на телефон

АгентЗаголовокТекст
ClineCline finished · apiПервые 300 символов результата Cline
Cline через MCPЧто напишет агентСводка, которую он решил отправить
AiderAider is waiting · apiYour turn: reply or confirm in the terminal.

Сообщения по умолчанию имеют обычный приоритет. Добавьте "level": "high" в JSON, если хотите, чтобы они проходили через Фокусирование на iPhone, или сделайте их тихими с "low" и проверяйте историю, когда вернётесь.

Если ничего не приходит

  • Запустите скрипт вручную. Для Cline: echo '{}' | ~/Documents/Cline/Hooks/TaskComplete; для Aider: ~/.config/pocketalert/aider-notify.sh. Если push не приходит, проверьте ключ или сеть; уберите >/dev/null 2>&1, чтобы увидеть ответ curl.
  • Проверьте имя файла. Cline сопоставляет хуки по имени: ровно TaskComplete, исполняемый, без .sh.
  • Проверьте ключ конфигурации Aider. Используйте notifications-command с дефисом, как в примере конфига Aider.

FAQ

Нужны ли оба агента?

Нет. Два раздела независимы; настройте тот, которым пользуетесь.

Могут ли Cline или Aider увидеть мой API-ключ?

Хук и команда уведомления читают ключ из файла и не входят в диалог. Конфиг MCP хранит ключ, чтобы Cline мог подключиться к серверу; ключ не отправляется модели.

Будет ли Aider засыпать меня уведомлениями, пока я за компьютером?

Он отправляет один push на каждый ответ. Если это слишком много, когда вы рядом, запускайте Aider без --notifications и включайте конфиг только для долгих сессий либо добавьте проверку в начало скрипта, например [ -f ~/.aider-away ] || exit 0, и создавайте этот файл, когда уходите.

Это бесплатно?

Да. Cline и Aider — открытое ПО, а бесплатный тариф Pocket Alert включает 50 сообщений в день на одно устройство.

Получите API-ключ, вставьте скрипт и позвольте агенту дать вам знать, когда он закончит.

Поделиться статьёй