Gemini CLI Reference: Hooks, Config, Permissions

Updated October 20, 2026 by Alex Sorokoletov

An independent reference for Gemini CLI (Google), with every table generated from the open-source repository at the v0.65.0 release tag and refreshed with each release. Each page answers the questions the official documentation leaves open: exact event order, payload fields, defaults, and what each setting blocks.

Pages

• Gemini CLI Hooks Reference: All 11 Gemini CLI hook events with examples, stdin and stdout JSON, matchers, millisecond timeouts, exit codes, why hooks do not run, Claude Code mapping.
• Gemini CLI Extensions Reference: Install, list, update and uninstall Gemini CLI extensions from GitHub, the gemini-extension.json manifest, and what an extension bundles: MCP, hooks, skills.
• Gemini CLI settings.json Reference: Gemini CLI settings.json location on macOS, Linux and Windows, a working example, merge order, $VAR expansion, MCP servers, and every key with its default.
• Gemini CLI Permissions and Policy Engine: Skip Gemini CLI permission prompts: YOLO, auto-accept edits, Always allow, policy engine TOML rules and tiers, sandbox, trusted folders, denial errors.

Common Gemini CLI questions

• Does Gemini CLI support hooks?
• Why are my Gemini CLI hooks not working?
• Is the Gemini CLI hook timeout in seconds or milliseconds?
• What are Gemini CLI extensions?
• How do I install a Gemini CLI extension?
• How do I update or uninstall an extension?
• Where is the Gemini CLI settings.json file?
• Which settings file wins in Gemini CLI?
• How do I set a proxy for Gemini CLI?
• What is the Gemini CLI policy engine?
• Is there a Gemini CLI equivalent of --dangerously-skip-permissions?
• How do I auto-approve only specific shell commands in Gemini CLI?

How these pages stay current

Tables on every page are regenerated from the Gemini CLI source with each release: hook events and payload schemas, configuration keys with their types and defaults, and permission modes. The version and date under each title are the release the tables were read from. Prose explains behaviour the tables cannot show, such as the order events fire in and which exit codes block, and cites the exact source files it relies on. Where the Google documentation and the code disagree, these pages follow the code and link both. Each page ends with a Sources list that links every file its tables were read from, pinned to the release tag, so any row can be checked against the exact code that shipped.

Release history

What changed in each Gemini CLI release, including new hooks, settings and permission modes, is tracked in the Gemini CLI version tracker.