Kembali ke Blog

Notifikasi push Gemini CLI: selesai, atau menunggu persetujuan

Notifikasi push Gemini CLI: selesai, atau menunggu persetujuan

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, dan aplikasi 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:

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:

#!/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 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 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:

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:

{
  "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:

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

EventJudulIsiLevel
Giliran selesaiGemini finished · api300 karakter pertama dari responsdefault
Izin toolGemini needs approval · apiPesan izin dari Gemini CLIhigh

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, Gemini bisa mengirim push yang ia tulis sendiri, pada momen yang Anda minta. Tambahkan dari baris perintah:

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:

{
  "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 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, tambahkan hook, dan biarkan Gemini menemukan Anda saat ia membutuhkan Anda.

Bagikan artikel ini