Назад в блог

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

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 CLIhigh

На 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 даст знать, когда вы ему понадобитесь.

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