Notifikasi Gemini CLI: dapatkan suara atau peringatan saat ia selesai atau membutuhkan Anda

Gemini CLI dengan santai diam di “Waiting for confirmation” selagi Anda membaca hal lain. Sebenarnya ia bisa memberi tahu Anda. Hanya saja pengaturannya nonaktif secara default, dan di Windows perilakunya berbeda dari yang tersirat di dokumentasi.

Sebelum mulai: Gemini CLI mana yang Anda miliki

Sebuah banner di dokumentasi Gemini CLI menyebutkan bahwa untuk pengguna tingkat gratis dan Google One, Gemini CLI digantikan oleh Antigravity CLI pada 18 Juni 2026. Semua yang ada di bawah ini membahas Gemini CLI itu sendiri (perintah gemini dan ~/.gemini/settings.json). Jika Anda sudah pindah ke Antigravity, pengaturannya berada di tempat lain.

Orang-orang sudah lama menginginkan fitur ini. Permintaan fitur notifikasi audio di repositori Gemini CLI (#4310) mengumpulkan 74 jempol, dan seorang maintainer menaikkan prioritasnya “to reflect how many people care” (untuk mencerminkan betapa banyak orang yang peduli). Diskusi berikutnya (#13313) merangkumnya dengan sederhana: “I can never tell when it is done.” (Saya tidak pernah tahu kapan ia selesai.)

Aktifkan notifikasi bawaan

Gemini CLI memiliki fitur notifikasi eksperimental. Fitur ini nonaktif secara default. Aktifkan di CLI dengan /settings → General → Enable Notifications, atau di file pengaturan Anda:

Setelah aktif, Gemini CLI memberi tahu Anda untuk dua event:

• Tindakan diperlukan: model sedang menunggu input Anda atau persetujuan alat.
• Sesi selesai: sebuah sesi berhasil diselesaikan.

Judul notifikasinya adalah “Gemini CLI needs your attention” dan “Gemini CLI session complete”. Gemini CLI tidak memutar suaranya sendiri: ia mengirim escape sequence ke terminal Anda, dan terminal yang menentukan apa yang terjadi.

Cara notifikasi sampai kepada Anda (dan mengapa Windows berbeda)

Pengaturan kedua, general.notificationMethod, menentukan cara peringatan dikirim. Nilainya adalah auto (default), osc9, osc777, dan bell.

Halaman notifikasi menyebutkan bahwa CLI memakai escape sequence OSC 9 dan beralih ke bel terminal sebagai cadangan. Kode sumbernya lebih spesifik. Dalam mode auto (packages/cli/src/utils/terminalNotifications.ts):

Jadi di Windows Terminal Anda mendapatkan bel, bukan toast. Apa yang dilakukan bel adalah pengaturan Windows Terminal: bellStyle menerima all, audible, window, taskbar, dan none, dan default-nya audible. Dengan all, Windows Terminal memutar suara dan membuat ikon taskbar berkedip; Anda dapat memilih suaranya dengan bellSound.

Jika Anda ingin mencoba notifikasi desktop sungguhan alih-alih bel, paksa metodenya:

Di dalam tmux atau screen, Gemini CLI membungkus sequence tersebut dalam passthrough escape agar tetap sampai ke terminal luar.

Suara Anda sendiri dengan hook

Jika Anda menginginkan suara tertentu, popup, atau pesan ke ponsel Anda, gunakan hook. Gemini CLI menjalankan perintah hook pada titik-titik tertentu dan menunggu hingga selesai. Ada dua event yang penting di sini:

• Notification terpicu saat CLI mengeluarkan peringatan sistem. Saat ini satu-satunya jenisnya adalah ToolPermission (sebuah alat sedang menunggu persetujuan Anda). Hook ini tidak dapat menyetujui atau memblokir apa pun; sifatnya hanya informatif.
• AfterAgent terpicu sekali per giliran, setelah respons akhir model. Halaman praktik terbaik Gemini sendiri merekomendasikannya saat “you only need to check the final completion” (Anda hanya perlu mengecek penyelesaian akhir).

Hook aktif secara default (hooksConfig.enabled). Hook mencetak tepat satu objek JSON ke stdout dan tidak ada yang lain ({} tidak masalah jika Anda tidak punya apa pun untuk disampaikan). Kode keluar 0 berarti sukses; 2 memblokir (dan hanya berpengaruh untuk event yang dapat memblokir); selain itu dianggap peringatan dan CLI tetap berjalan. Timeout default-nya 60 detik (timeout dalam milidetik).

Windows (PowerShell)

Di Windows, Gemini CLI menjalankan perintah hook dengan pwsh -NoProfile -Command, atau powershell.exe jika PowerShell 7 tidak terpasang. Simpan skrip ini sebagai %USERPROFILE%\.gemini\hooks\ding.ps1:

Lalu arahkan kedua event ke skrip tersebut:

-ExecutionPolicy Bypass menghindari kegagalan yang paling umum: PowerShell menolak menjalankan skrip. Dokumentasi Gemini menyarankan Set-ExecutionPolicy RemoteSigned -Scope CurrentUser sebagai solusi permanen.

macOS dan Linux

Di sistem lain, hook berjalan dengan bash -c. Skrip satu baris sudah cukup:

Jadikan skrip itu executable (chmod +x ~/.gemini/hooks/ding.sh) dan gunakan "command": "$HOME/.gemini/hooks/ding.sh" pada dua event yang sama.

Ingin dua suara berbeda, satu untuk “membutuhkan persetujuan” dan satu untuk “selesai”? Buat dua skrip. Hook juga dapat membaca event dari stdin: input Notification membawa notification_type, message, dan details, sehingga Anda bisa menampilkan permintaan yang sebenarnya di popup.

Mengapa hook Anda tidak berjalan

1. Cek /hooks panel. Perintah ini menampilkan setiap hook yang dimuat Gemini CLI. /hooks enable-all mengaktifkannya kembali jika sebelumnya dinonaktifkan.
2. Folder tidak tepercaya. Di folder yang tidak tepercaya, Gemini CLI mengabaikan .gemini/settings.json milik proyek, sehingga hook proyek tidak dimuat. Letakkan hook notifikasi di pengaturan pengguna Anda (~/.gemini/settings.json) agar berfungsi di mana saja.
3. Hook yang diubah dianggap baru. Gemini CLI membuat sidik jari (fingerprint) untuk hook proyek; jika nama atau perintah sebuah hook berubah, hook itu diperlakukan sebagai hook baru yang tidak tepercaya.
4. Ada hal lain di stdout. echo yang nyasar atau peringatan PowerShell di depan JSON akan merusak parsing. Kirim log ke stderr.
5. Matcher. Untuk Notification dan AfterAgent, gunakan "*" (atau string kosong) untuk mencocokkan semuanya. Event lifecycle memakai matcher string persis, event alat memakai regular expression.

Atau kurangi frekuensi pertanyaannya

Notifikasi membantu Anda menjawab lebih cepat; Anda juga bisa mengurangi seberapa sering Gemini CLI membutuhkan Anda. general.defaultApprovalMode dapat bernilai default (bertanya), auto_edit (pengeditan disetujui, selebihnya bertanya), atau plan (read-only). Shift+Tab berpindah di antara mode-mode tersebut. tools.allowed berisi daftar alat yang melewati dialog konfirmasi (misalnya run_shell_command(git)), dan tools.confirmationRequired berisi daftar alat yang harus selalu bertanya.

Mode YOLO (--yolo, atau Ctrl+Y) menyetujui semuanya dan mengaktifkan sandbox secara default. Mode ini hanya dapat diaktifkan dari baris perintah, dan security.disableYoloMode menonaktifkannya secara permanen jika Anda berbagi mesin dengan orang lain.

Peran Pet Island

Bunyi bip memberi tahu Anda bahwa sesuatu terjadi; bunyi itu tidak memberi tahu terminal mana, atau apa yang ingin dijalankan Gemini. Pet Island menempatkan Gemini CLI di sebuah island kecil di bagian atas layar Anda di samping agen-agen Anda yang lain: Anda bisa melihat kapan ia sedang bekerja, kapan ia menunggu konfirmasi Anda, dan kapan ia selesai, dengan sekali klik untuk melompat ke terminal yang tepat.

Dengan Gemini CLI, konfirmasinya sendiri tetap terjadi di Gemini. Pet Island menampilkan permintaan dan membawa Anda ke sana, tetapi tidak menyetujui alat Gemini untuk Anda. (Sebaliknya, permintaan Claude Code dan Codex dapat dijawab langsung di island.)

FAQ

Sumber

Setiap pengaturan dan perilaku di halaman ini telah dicocokkan dengan halaman-halaman berikut pada 26 Oktober 2026. Agen berubah dengan cepat; jika ada yang tidak lagi sesuai, halaman resmi yang berlaku.

• Dokumentasi Gemini CLI: Notifications (eksperimental)
• Dokumentasi Gemini CLI: Hooks
• Dokumentasi Gemini CLI: Hooks reference
• Dokumentasi Gemini CLI: Writing hooks (contoh PowerShell)
• Dokumentasi Gemini CLI: Configuration reference
• Dokumentasi Gemini CLI: Trusted folders
• Kode sumber Gemini CLI: terminalNotifications.ts
• Issue Gemini CLI #4310: Audio notifications
• Diskusi Gemini CLI #13313: Enable sound when Gemini is done
• Microsoft Learn: Pengaturan profil Windows Terminal (bellStyle, bellSound)
• Microsoft Learn: Console.Beep

BACA JUGA