# Notifikasi push Gemini CLI: selesai, atau menunggu persetujuan

> Kirim push notification ke ponsel saat Gemini CLI menyelesaikan satu giliran atau meminta izin menjalankan tool. Dua hook di settings.json, satu skrip, plus server MCP Pocket Alert.

*15.10.2026*

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

Gemini CLI bisa memberi tahu Anda sendiri, tetapi hanya lewat terminal: aktifkan `general.enableNotifications` dan ia mengirim notifikasi desktop atau bunyi bel saat selesai atau membutuhkan Anda. Itu membantu saat Anda berada di depan komputer dan terminalnya ada di tab lain. Itu tidak berguna saat Anda tidak di depan komputer.

Hook menutup celah ini. Sejak v0.26, hook aktif secara default, dan dua event di antaranya tepat untuk push notification ke ponsel:

- **AfterAgent**: Gemini selesai menjalankan giliran. Payload-nya menyertakan respons.
- **Notification**: Gemini meminta izin untuk menjalankan tool.

Panduan ini mengirim keduanya ke ponsel Anda melalui Pocket Alert.

## Catatan tentang Gemini CLI yang mana

Sejak 18 Juni 2026, dokumentasi Google menyatakan bahwa Gemini CLI digantikan oleh Antigravity CLI untuk paket gratis dan paket Google One. Gemini CLI tetap berlanjut dengan kunci API Gemini berbayar, Vertex AI, atau akses enterprise, dan itulah yang dibahas panduan ini. Jika Anda memakai Antigravity CLI, periksa dokumentasinya untuk hook.

## Yang Anda butuhkan

- Gemini CLI v0.26 atau yang lebih baru.
- `jq` dan `curl`.
- Akun Pocket Alert, kunci API dari [Kunci API](/account/apikeys), dan [aplikasi](/get-app) di ponsel Anda. Paket Gratis sudah cukup.

Simpan kunci di sebuah file. Gemini CLI dapat menghapus variabel lingkungan yang namanya memuat `KEY` atau `TOKEN` sebelum menjalankan hook, ketika redaksi lingkungan aktif atau saat dijalankan di GitHub Actions. Kunci yang dibaca dari file tidak terpengaruh:

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

## Langkah 1. Skrip hook

Gemini CLI mengirim setiap hook sebuah objek JSON lewat stdin dengan `hook_event_name` dan `cwd`. `AfterAgent` menambahkan `prompt_response`; `Notification` menambahkan `notification_type` dan `message`. Simpan sebagai `~/.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 mengurai stdout hook sebagai JSON, jadi skrip hanya mencetak `{}` dan tidak ada yang lain; output curl diarahkan ke `/dev/null`. Kode keluar 2 dari hook `AfterAgent` akan menolak respons dan membuat Gemini mencoba ulang, jadi skrip tidak pernah mengembalikannya.

### Atau dengan Pocket Alert CLI

Dengan [Pocket Alert CLI](/tools/cli) 2.0 atau yang lebih baru terpasang, blok curl menyusut menjadi satu perintah. CLI sendiri melakukan escape pada teks dan mengambil kunci dari `pocketalert auth`, yang juga menghindari penghapusan variabel di atas:

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

Gunakan `-t` dan `-m`, bukan argumen posisional: balasan yang diawali tanda hubung, seperti daftar Markdown, akan dibaca sebagai opsi.

## Langkah 2. Daftarkan hook

Tambahkan blok `hooks` ke `~/.gemini/settings.json`, digabungkan dengan isi yang sudah ada:

```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
          }
        ]
      }
    ]
  }
}
```

Ganti `/Users/you` dengan direktori home Anda. `timeout` di sini dalam milidetik, berbeda dengan beberapa agen lain. Untuk satu proyek, letakkan blok yang sama di `.gemini/settings.json` dalam repositori; Gemini CLI hanya menjalankan hook proyek di folder tepercaya.

## Langkah 3. Uji coba

Jalankan skrip dengan event tiruan terlebih dahulu:

```bash
echo '{"hook_event_name":"AfterAgent","cwd":"/tmp/demo","prompt_response":"Hook test"}' \
  | ~/.gemini/hooks/pocketalert.sh
```

Lalu mulai Gemini CLI dan berikan tugas yang diakhiri dengan pemanggilan tool yang membutuhkan persetujuan, misalnya "buat file bernama notes.txt". Anda akan menerima **Gemini needs approval** saat ia menunggu, dan **Gemini finished** setelah Anda mengizinkan dan giliran berakhir.

## Yang masuk ke ponsel Anda

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Event</th><th>Judul</th><th>Isi</th><th>Level</th></tr></thead>
<tbody>
<tr><th>Giliran selesai</th><td>Gemini finished · api</td><td>300 karakter pertama dari respons</td><td>default</td></tr>
<tr><th>Izin tool</th><td>Gemini needs approval · api</td><td>Pesan izin dari Gemini CLI</td><td>high</td></tr>
</tbody>
</table>
</div>

`high` tiba sebagai time-sensitive di iPhone, sehingga permintaan persetujuan tetap lolos dari Fokus. Setiap push tetap tersimpan di aplikasi dan dasbor web.

## Atau biarkan Gemini mengirimnya lewat MCP

Dengan [server MCP Pocket Alert](/tools/mcp), Gemini bisa mengirim push yang ia tulis sendiri, pada momen yang Anda minta. Tambahkan dari baris perintah:

```bash
gemini mcp add --scope user --transport http \
  --header 'Authorization: Bearer $POCKETALERT_API_KEY' \
  pocketalert https://mcp.pocketalert.app/mcp
```

Tanda kutip tunggal membuat `$POCKETALERT_API_KEY` tetap sebagai variabel di file pengaturan, alih-alih menuliskan kuncinya ke sana; Gemini CLI memperluasnya saat terhubung, jadi ekspor variabel itu di shell yang menjalankan `gemini`. Tanpa `--scope user`, server hanya ditambahkan ke proyek saat ini.

Hasilnya di `~/.gemini/settings.json`:

```json
{
  "mcpServers": {
    "pocketalert": {
      "url": "https://mcp.pocketalert.app/mcp",
      "type": "http",
      "headers": { "Authorization": "Bearer $POCKETALERT_API_KEY" }
    }
  }
}
```

Jalankan `/mcp` di dalam Gemini CLI untuk melihat server dan tool-nya. Lalu prompt seperti "jalankan migrasi dan kirim saya jumlah baris saat selesai" akan diakhiri dengan pemanggilan `create_message`.

## Jika tidak ada yang masuk

- **Jalankan perintah uji.** Tidak ada push berarti masalah ada di kunci atau jaringan; hapus `>/dev/null 2>&1` untuk melihat respons curl.
- **Periksa hook sudah aktif.** Hook aktif secara default, tetapi `hooksConfig.enabled: false` di pengaturan akan mematikannya.
- **Periksa path** di `command` bersifat absolut dan skripnya bisa dieksekusi.
- **Periksa stdout.** Apa pun selain JSON di stdout membuat Gemini CLI mengabaikan hasil hook. Pastikan tidak ada bagian lain dari skrip yang mencetak sesuatu.

## FAQ

### Apa bedanya dengan `general.enableNotifications`?

Pengaturan itu mengirim notifikasi terminal ke komputer Anda saat Gemini membutuhkan Anda atau selesai. Hook menjalankan perintah apa pun, sehingga bisa menjangkau ponsel Anda, menyimpan riwayat, dan memakai level prioritas.

### Bisakah saya menyetujui pemanggilan tool dari ponsel?

Tidak dengan skrip ini: ia memberi tahu Anda bahwa Gemini sedang menunggu, dan persetujuan dilakukan di terminal. Hook `BeforeTool` dapat memblokir pemanggilan tool, sehingga gerbang persetujuan mungkin dibuat dengan endpoint yang dipanggil ponsel Anda; [Notifikasi human-in-the-loop](/blog/human-in-the-loop-notifications) menunjukkan polanya.

### Apakah ini berfungsi di GitHub Actions?

Ya, dan pendekatan file kunci penting di sana: di GitHub Actions, Gemini CLI menghapus variabel yang memuat `KEY` atau `TOKEN` dalam namanya dari lingkungan hook. Tulis kunci dari secret ke sebuah file pada langkah sebelumnya.

### Apakah ini gratis?

Hook merupakan bagian dari Gemini CLI, dan paket Gratis Pocket Alert mencakup 50 pesan per hari untuk satu perangkat. Gemini sendiri memerlukan kunci API berbayar atau akses enterprise untuk CLI, seperti disebutkan di atas.

[Dapatkan kunci API](/signup), tambahkan hook, dan biarkan Gemini menemukan Anda saat ia membutuhkan Anda.
