Назад в блог

Cursor push-уведомления: сигнал на телефон, когда агент закончил

Cursor push-уведомления: сигнал на телефон, когда агент закончил

Агент Cursor может отрефакторить модуль, пока вы варите кофе, но при обычном локальном запуске Cursor сообщает о завершении только на компьютере: звуком или системным уведомлением, если вы их включили. Приложение Cursor для iOS отправляет push, когда агент заканчивает ход, но только для облачных агентов и сессий, которые вы передаёте через Remote Control, при платном тарифе и на iPhone. Для Android поддержка пока не запланирована.

Если вы хотите получать push-уведомление на телефон, когда локальный запуск агента завершился, Cursor предлагает два способа его отправить:

  • Хук stop. Cursor запускает ваш скрипт каждый раз, когда цикл агента завершается: успешно, прерванно или с ошибкой. Надёжно и всегда одинаково.
  • Инструмент MCP. Добавьте MCP-сервер Pocket Alert, и агент сможет отправить вам push, когда вы его попросите, с сообщением, которое он сам напишет.

Это руководство настраивает оба способа. Каждый займёт несколько минут.

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

  • Cursor 1.7 или новее: хуки появились в версии 1.7.
  • jq и curl для хука.
  • Аккаунт Pocket Alert, API-ключ из раздела API Keys и приложение на телефоне. Бесплатного тарифа достаточно.

Cursor, запущенный из Dock, не читает ваш .zshrc, поэтому переменные окружения, которые вы экспортируете там, он не видит. Храните ключ в файле:

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

Вариант 1. Хук stop для каждого запуска

Скрипт

Cursor передаёт хуку JSON-объект через stdin. Для stop в нём есть status (completed, aborted или error) и workspace_roots, то есть папки, открытые в окне. Сохраните скрипт как ~/.cursor/hooks/pocketalert.sh:

#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.workspace_roots[0] // "cursor"' <<<"$payload")")
status=$(jq -r '.status // "completed"' <<<"$payload")

case "$status" in
  completed) title="Cursor finished · $project"; level=default ;;
  error)     title="Cursor hit an error · $project"; level=high ;;
  *)         echo '{}'; exit 0 ;;
esac

jq -n --arg t "$title" --arg m "Agent run $status" --arg l "$level" \
  '{title: $t, message: $m, level: $l}' |
  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 '{}'
chmod +x ~/.cursor/hooks/pocketalert.sh

Прерванные запуски намеренно пропускаются: если вы нажали «стоп», вы и так это знаете. Скрипт выводит {}, потому что хук stop может вернуть followup_message, который Cursor отправляет агенту как ваш следующий промпт. Пустой объект означает «ничего не добавлять».

Или через Pocket Alert CLI

Если установлен Pocket Alert CLI версии 2.0 или новее, блок с curl сводится к одной команде. CLI сам экранирует текст и берёт ключ из pocketalert auth:

pocketalert send -t "$title" -m "Agent run $status" -l "$level" -q >/dev/null 2>&1 || true

Используйте -t и -m, а не позиционные аргументы: ответ, который начинается с дефиса, например с Markdown-списка, иначе будет прочитан как опция.

Регистрация

Создайте ~/.cursor/hooks.json:

{
  "version": 1,
  "hooks": {
    "stop": [
      { "command": "/Users/you/.cursor/hooks/pocketalert.sh", "timeout": 10 }
    ]
  }
}

Укажите абсолютный путь к скрипту и замените /Users/you на свою домашнюю папку. Файл в домашней папке действует для всех проектов. Если нужен только один проект, положите его в .cursor/hooks.json внутри репозитория.

Cursor сам перечитывает hooks.json при изменении файла. Дайте агенту небольшую задачу, и по завершении на телефоне появится Cursor finished · your-project.

Хотите в push ответ агента?

stop не передаёт ответ агента, а afterAgentResponse передаёт его в поле text. Чтобы отправлять в push первые строки ответа, а не только статус, зарегистрируйте такой же скрипт на afterAgentResponse и читайте .text из stdin. Он срабатывает после каждого ответа, поэтому шумнее, и большинство людей оставляют stop.

Вариант 2. MCP-сервер

Хук сообщает, что запуск завершился. MCP-сервер позволяет агенту рассказать, что произошло. Добавьте Pocket Alert в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "pocketalert": {
      "url": "https://mcp.pocketalert.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Ключ записывается прямо в файл из-за проблемы с Dock, описанной выше. Этот файл лежит в домашней папке, а не в репозитории. Если вы запускаете Cursor из терминала, где ключ экспортирован, вместо него работает "Bearer ${env:POCKETALERT_API_KEY}".

Откройте раздел MCP в настройках Cursor, убедитесь, что у pocketalert видны инструменты, и попросите:

> Run the test suite. When it's done, push me the number of failures with Pocket Alert.

Агент вызывает create_message с написанным им самим кратким описанием. Он также может задать level, поэтому упавший набор тестов придёт с high, а на платном тарифе можно прикрепить кнопки действий.

Чтобы это стало привычкой, а не инструкцией в каждом промпте, добавьте правило для проекта:

When a task takes more than a few minutes, finish by calling the pocketalert
create_message tool with a one-line summary. Use level "high" if anything failed.

Что выбрать

Хук stopИнструмент MCP
СрабатываетКаждый запуск, всегдаКогда агент решит
СообщениеСтатус: completed или errorВсё, что напишет агент
НужноСкрипт и hooks.jsonОдин блок в mcp.json
Может молча не сработатьТолько если нет сетиЕсли модель забудет

Лучший вариант по умолчанию — использовать оба: хук гарантирует, что вы узнаете о каждом запуске, а инструмент MCP даёт содержание там, где оно важно.

Подтверждения

У Cursor нет хука для ситуации «агент ждёт подтверждения». beforeShellExecution и preToolUse срабатывают перед каждой командой, включая те, которые Cursor выполняет без запроса, поэтому они не могут сообщить, когда вы действительно нужны. Этот случай сейчас покрывают системные уведомления настольной версии Cursor и его приложение для iOS.

Если вы хотите, чтобы агент остановился и спросил перед рискованным шагом, дайте ему инструмент MCP и правило отправлять push с кнопками «Подтвердить» и «Отклонить». Уведомления с участием человека показывают, как сделать из этого настоящий барьер, а не вежливую просьбу.

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

  • Запустите скрипт вручную: echo '{"status":"completed","workspace_roots":["/tmp/demo"]}' | ~/.cursor/hooks/pocketalert.sh. Если push не пришёл, уберите >/dev/null 2>&1, чтобы увидеть ошибку curl.
  • Перезапустите Cursor, если хук всё равно не срабатывает. Обычно Cursor сам перечитывает hooks.json при изменении файла.
  • Проверьте путь в hooks.json: он должен быть абсолютным, а скрипт — исполняемым.
  • Для MCP проверьте список инструментов. Ошибка рядом с сервером в настройках MCP Cursor обычно значит, что ключ неверный или пустой.

FAQ

Есть ли в Cursor push-уведомления из коробки?

На компьютере есть: звук завершения и системные уведомления. На телефоне приложение Cursor для iOS отправляет push, когда облачный агент или сессия, переданная через Remote Control, завершает ход. Нужен платный тариф и iPhone. Обычные локальные запуски остаются на компьютере, и именно их покрывает эта настройка.

Будет ли это работать для фоновых и облачных агентов?

Хук в ~/.cursor/hooks.json работает только на вашей машине, поэтому он охватывает агентов, запущенных локально. Облачные агенты работают на серверах Cursor: они выполняют проектные хуки из .cursor/hooks.json репозитория, но не пользовательские, и файла с ключом там нет. Для них подойдёт MCP, если сервер настроен у агента, или интеграция приложения Cursor для iOS или Slack.

Видит ли агент мой API-ключ?

В настройке с хуком — нет: ключ хранится в файле, который читает только скрипт. В настройке с MCP ключ лежит в конфигурации Cursor и отправляется MCP-серверу, а не модели.

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

Да. Хуки и MCP входят в Cursor, а бесплатный тариф Pocket Alert покрывает 50 сообщений в день на одном устройстве.

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

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