Push-уведомления Gemini CLI: готово или ждёт подтверждения

Gemini CLI умеет уведомлять вас сам, но только в терминале: включите general.enableNotifications, и он отправит системное уведомление или звуковой сигнал, когда закончит работу или потребует вашего участия. Это удобно, когда вы у компьютера и терминал открыт в другой вкладке. Если вас рядом нет, это не поможет.
Хуки закрывают этот разрыв. Начиная с v0.26 они включены по умолчанию, и два события как раз подходят для push-уведомлений на телефон:
- AfterAgent: Gemini завершил ход. Полезная нагрузка включает ответ.
- Notification: Gemini запрашивает разрешение на запуск инструмента.
Это руководство отправляет оба события на ваш телефон через Pocket Alert.
Какой Gemini CLI вы используете
С 18 июня 2026 года, как написано в документации Google, Gemini CLI заменён на Antigravity CLI для бесплатного тарифа и планов Google One. Сам Gemini CLI продолжает работать с платным API-ключом Gemini, Vertex AI или корпоративным доступом, и именно о нём это руководство. Если вы используете Antigravity CLI, посмотрите документацию по хукам в нём.
Что понадобится
- Gemini CLI версии v0.26 или новее.
jqиcurl.- Аккаунт Pocket Alert, API-ключ из раздела API Keys и приложение на телефоне. Бесплатного тарифа достаточно.
Сохраните ключ в файл. Gemini CLI может удалять переменные окружения, в именах которых есть KEY или TOKEN, перед запуском хуков, если включено маскирование окружения или он работает в GitHub Actions. Ключ, прочитанный из файла, на это не влияет:
mkdir -p ~/.config/pocketalert
printf '%s' 'YOUR_API_KEY' > ~/.config/pocketalert/key
chmod 600 ~/.config/pocketalert/key
Шаг 1. Скрипт хука
Gemini CLI передаёт каждому хуку JSON-объект через stdin с полями hook_event_name и cwd. AfterAgent добавляет prompt_response, а Notification добавляет notification_type и message. Сохраните файл как ~/.gemini/hooks/pocketalert.sh:
#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.cwd' <<<"$payload")")
case "$(jq -r '.hook_event_name' <<<"$payload")" in
AfterAgent)
title="Gemini finished · $project"
message=$(jq -r '.prompt_response // "Turn complete"' <<<"$payload")
level=default ;;
Notification)
title="Gemini needs approval · $project"
message=$(jq -r '.message // "Waiting for tool permission"' <<<"$payload")
level=high ;;
*) echo '{}'; exit 0 ;;
esac
jq -n --arg t "$title" --arg m "${message:0:300}" --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 ~/.gemini/hooks/pocketalert.sh
Gemini CLI разбирает stdout хука как JSON, поэтому скрипт выводит только {}. Вывод curl направлен в /dev/null. Код выхода 2 из хука AfterAgent отклонил бы ответ и заставил Gemini повторить запрос, поэтому скрипт никогда его не возвращает.
Или с CLI Pocket Alert
Если установлен CLI Pocket Alert версии 2.0 или новее, блок с curl сводится к одной команде. CLI сам экранирует текст и берёт ключ из pocketalert auth, что также обходит удаление переменных, описанное выше:
pocketalert send -t "$title" -m "${message:0:300}" -l "$level" -q >/dev/null 2>&1 || true
Используйте -t и -m, а не позиционные аргументы: ответ, который начинается с дефиса, например с пункта Markdown-списка, иначе был бы принят за опцию.
Шаг 2. Зарегистрируйте хуки
Добавьте блок hooks в ~/.gemini/settings.json, объединив его с существующим содержимым:
{
"hooks": {
"AfterAgent": [
{
"matcher": "*",
"hooks": [
{
"name": "pocketalert-done",
"type": "command",
"command": "/Users/you/.gemini/hooks/pocketalert.sh",
"timeout": 10000
}
]
}
],
"Notification": [
{
"matcher": "*",
"hooks": [
{
"name": "pocketalert-approval",
"type": "command",
"command": "/Users/you/.gemini/hooks/pocketalert.sh",
"timeout": 10000
}
]
}
]
}
}
Замените /Users/you на путь к своей домашней директории. Здесь timeout задаётся в миллисекундах, в отличие от некоторых других агентов. Чтобы настроить хуки для одного проекта, поместите тот же блок в .gemini/settings.json в репозитории: Gemini CLI запускает хуки проекта только в доверенной папке.
Шаг 3. Проверьте работу
Сначала запустите скрипт с тестовым событием:
echo '{"hook_event_name":"AfterAgent","cwd":"/tmp/demo","prompt_response":"Hook test"}' \
| ~/.gemini/hooks/pocketalert.sh
Затем запустите Gemini CLI и дайте задачу, которая заканчивается вызовом инструмента, требующим подтверждения, например «создай файл notes.txt». Пока Gemini ждёт, вы получите Gemini needs approval, а после того как разрешите действие и ход завершится, придёт Gemini finished.
Что приходит на телефон
| Событие | Заголовок | Текст | Уровень |
|---|---|---|---|
| Ход завершён | Gemini finished · api | Первые 300 символов ответа | default |
| Разрешение инструмента | Gemini needs approval · api | Сообщение о разрешении от Gemini CLI | high |
На iPhone уровень high приходит как важное по времени, поэтому запросы на подтверждение проходят через Фокусирование. Каждое push-уведомление сохраняется в приложении и в веб-панели.
Или пусть Gemini отправит через MCP
С MCP-сервером Pocket Alert Gemini может отправлять push-уведомления, которые формирует сам, в моменты, которые вы укажете. Добавьте сервер из командной строки:
gemini mcp add --scope user --transport http \
--header 'Authorization: Bearer $POCKETALERT_API_KEY' \
pocketalert https://mcp.pocketalert.app/mcp
Одинарные кавычки сохраняют $POCKETALERT_API_KEY как переменную в файле настроек, а не записывают ключ в него. Gemini CLI подставит значение при подключении, поэтому экспортируйте переменную в оболочке, из которой запускается gemini. Без --scope user сервер добавляется только для текущего проекта.
Результат в ~/.gemini/settings.json:
{
"mcpServers": {
"pocketalert": {
"url": "https://mcp.pocketalert.app/mcp",
"type": "http",
"headers": { "Authorization": "Bearer $POCKETALERT_API_KEY" }
}
}
}
Выполните /mcp внутри Gemini CLI, чтобы увидеть сервер и его инструменты. Затем запрос вида «запусти миграцию и пришли мне количество строк, когда она закончится» завершится вызовом create_message.
Если ничего не приходит
- Запустите тестовую команду. Если push-уведомления нет, проблема в ключе или в сети. Уберите
>/dev/null 2>&1, чтобы увидеть ответ curl. - Проверьте, что хуки включены. По умолчанию они включены, но
hooksConfig.enabled: falseв настройках их отключает. - Проверьте путь в
command: он должен быть абсолютным, а скрипт должен быть исполняемым. - Проверьте stdout. Всё, что выводится в stdout, кроме JSON, заставляет Gemini CLI игнорировать результат хука. Убедитесь, что в скрипте ничего больше не печатает.
FAQ
Чем это отличается от general.enableNotifications?
Эта настройка показывает уведомления в терминале на вашем компьютере, когда Gemini ждёт вас или завершает работу. Хуки запускают любую команду, поэтому они могут доставить уведомление на телефон, сохранить историю и использовать уровни приоритета.
Могу ли я подтвердить вызов инструмента с телефона?
Не с этим скриптом: он сообщает, что Gemini ждёт, а подтверждаете вы в терминале. Хук BeforeTool может блокировать вызов инструмента, поэтому шлюз подтверждения возможен через эндпоинт, к которому обращается телефон. Схему показывает статья Уведомления для человека в контуре.
Работает ли это в GitHub Actions?
Да, и здесь важен подход с файлом ключа: в GitHub Actions Gemini CLI удаляет из окружения хука переменные, в именах которых есть KEY или TOKEN. Запишите ключ из секрета в файл на более раннем шаге.
Это бесплатно?
Хуки входят в Gemini CLI, а бесплатный тариф Pocket Alert покрывает 50 сообщений в день на одном устройстве. Сам Gemini для CLI требует платный API-ключ или корпоративный доступ, как было сказано выше.
Получите API-ключ, добавьте хуки и пусть Gemini даст знать, когда вы ему понадобитесь.