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 сообщит, когда работа завершена.