Latest stable release: v0.31.0

Released: February 27, 2026

For most users, our latest stable release is the recommended release. Install the latest stable version with:

npm install -g @google/gemini-cli

Highlights

Gemini 3.1 Pro Preview: Support for the new Gemini 3.1 Pro Preview models with improved reasoning and context handling.
Experimental Browser Agent: Introduced a new experimental agent that can interact directly with web pages to perform complex tasks.
Project-Level Policy: Support for project-level policy enforcement, allowing for more granular control over tools and security.
Direct Web Fetch: Implementation of a direct web fetch tool with built-in rate limiting to prevent abuse and ensure stability.
Plan Mode Enhancements: Support for automatic model switching, custom storage directory configuration, and post-execution work summaries.

feat(models): support Gemini 3.1 Pro Preview and fixes by @sehoon38 in #19676
feat(browser): implement experimental browser agent by @gsquared94 in #19284
feat(policy): implement project-level policy support by @Abhijit-2592 in #18682
feat(core): implement experimental direct web fetch by @mbleigh in #19557
fix(security): rate limit web_fetch tool to mitigate DDoS via prompt injection by @mattKorwel in #19567
feat(plan): support automatic model switching for Plan Mode by @jerop in #20240
feat(plan): summarize work after executing a plan by @jerop in #19432
feat(plan): support configuring custom plans storage directory by @jerop in #19577
feat(policy): Support MCP Server Wildcards in Policy Engine by @jerop in #20024
feat(policy): Implement Tool Annotation Matching in Policy Engine by @jerop in #20029
feat(cli): add gemini --resume hint on exit by @Mag1ck in #16285
feat(cli): add macOS run-event notifications (interactive only) by @LyalinDotCom in #19056
feat(cli): enhance folder trust with configuration discovery and security warnings by @galz10 in #19492
security: implement deceptive URL detection and disclosure in tool confirmations by @ehedlund in #19288
security: strip deceptive Unicode characters from terminal output by @ehedlund in #19026
fix(patch): cherry-pick 32e777f for v0.31.0-preview.3 release by @gemini-cli-robot in #20621

Full Changelog: https://github.com/google-gemini/gemini-cli/compare/v0.30.1...v0.31.0