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

> Отправляйте push-уведомление на телефон, когда Gemini CLI завершит ход или попросит разрешение на запуск инструмента. Два хука в settings.json, один скрипт и MCP-сервер Pocket Alert.

*15.10.2026*

<!-- source: https://pocketalert.app/ru/blog/gemini-cli-notifications -->

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](/account/apikeys) и [приложение](/get-app) на телефоне. Бесплатного тарифа достаточно.

Сохраните ключ в файл. Gemini CLI может удалять переменные окружения, в именах которых есть `KEY` или `TOKEN`, перед запуском хуков, если включено маскирование окружения или он работает в GitHub Actions. Ключ, прочитанный из файла, на это не влияет:

```bash
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`:

```bash
#!/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 '{}'
```

```bash
chmod +x ~/.gemini/hooks/pocketalert.sh
```

Gemini CLI разбирает stdout хука как JSON, поэтому скрипт выводит только `{}`. Вывод curl направлен в `/dev/null`. Код выхода 2 из хука `AfterAgent` отклонил бы ответ и заставил Gemini повторить запрос, поэтому скрипт никогда его не возвращает.

### Или с CLI Pocket Alert

Если установлен [CLI Pocket Alert](/tools/cli) версии 2.0 или новее, блок с curl сводится к одной команде. CLI сам экранирует текст и берёт ключ из `pocketalert auth`, что также обходит удаление переменных, описанное выше:

```bash
pocketalert send -t "$title" -m "${message:0:300}" -l "$level" -q >/dev/null 2>&1 || true
```

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

## Шаг 2. Зарегистрируйте хуки

Добавьте блок `hooks` в `~/.gemini/settings.json`, объединив его с существующим содержимым:

```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. Проверьте работу

Сначала запустите скрипт с тестовым событием:

```bash
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**.

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

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Событие</th><th>Заголовок</th><th>Текст</th><th>Уровень</th></tr></thead>
<tbody>
<tr><th>Ход завершён</th><td>Gemini finished · api</td><td>Первые 300 символов ответа</td><td>default</td></tr>
<tr><th>Разрешение инструмента</th><td>Gemini needs approval · api</td><td>Сообщение о разрешении от Gemini CLI</td><td>high</td></tr>
</tbody>
</table>
</div>

На iPhone уровень `high` приходит как важное по времени, поэтому запросы на подтверждение проходят через Фокусирование. Каждое push-уведомление сохраняется в приложении и в веб-панели.

## Или пусть Gemini отправит через MCP

С [MCP-сервером Pocket Alert](/tools/mcp) Gemini может отправлять push-уведомления, которые формирует сам, в моменты, которые вы укажете. Добавьте сервер из командной строки:

```bash
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`:

```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` может блокировать вызов инструмента, поэтому шлюз подтверждения возможен через эндпоинт, к которому обращается телефон. Схему показывает статья [Уведомления для человека в контуре](/blog/human-in-the-loop-notifications).

### Работает ли это в GitHub Actions?

Да, и здесь важен подход с файлом ключа: в GitHub Actions Gemini CLI удаляет из окружения хука переменные, в именах которых есть `KEY` или `TOKEN`. Запишите ключ из секрета в файл на более раннем шаге.

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

Хуки входят в Gemini CLI, а бесплатный тариф Pocket Alert покрывает 50 сообщений в день на одном устройстве. Сам Gemini для CLI требует платный API-ключ или корпоративный доступ, как было сказано выше.

[Получите API-ключ](/signup), добавьте хуки и пусть Gemini даст знать, когда вы ему понадобитесь.
