Gemini CLI Hooks

April 23, 2026 · View on GitHub

Hooks Version Stars

Gemini CLI mascot speaking

Sound notifications for every Gemini CLI hook event — session, agent, model, and tool lifecycle

Installation

Mac  Linux  Windows

How to Use

Step 1. Start Gemini CLI:

gemini

Step 2. Send a prompt (e.g., Hi) — you'll hear a sound on session start, tool use, agent response, and more.

Common Errors

If prerequisites are missing, you'll see an error on Gemini CLI start:

SessionStart hook error

Verify Python 3 is installed (python3 --version) and that .gemini/hooks/scripts/hooks.py exists in your project.

Changelog

DateHooksChangesGemini CLI Version
Apr 22, 202611Initial release: all 11 Gemini CLI hooks (SessionStart, SessionEnd, BeforeAgent, AfterAgent, BeforeModel, AfterModel, BeforeToolSelection, BeforeTool, AfterTool, PreCompress, Notification)v0.38.2

Other Repos

Claude Code Hooks
Claude Code
Hooks 		Codex CLI Hooks
Codex CLI
Hooks 		Claude Code Best Practice
Claude Code
Best Practice 		Gemini CLI Best Practice
Gemini CLI
Best Practice 		Codex CLI Best Practice
Codex CLI
Best Practice

If you like my work, buy me a doodh patti 🍵 on

Polar Polar