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.
jqdancurl.- 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
| Event | Judul | Isi | Level |
|---|---|---|---|
| Giliran selesai | Gemini finished · api | 300 karakter pertama dari respons | default |
| Izin tool | Gemini needs approval · api | Pesan izin dari Gemini CLI | high |
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>&1untuk melihat respons curl. - Periksa hook sudah aktif. Hook aktif secara default, tetapi
hooksConfig.enabled: falsedi pengaturan akan mematikannya. - Periksa path di
commandbersifat 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.