Latest stable release: v0.42.0

Released: May 12, 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

• Auto Memory Inbox: Introduced a new inbox flow for Auto Memory using a canonical-patch contract, enabling more robust and manageable skill extraction.
• Gemma 4 Default: Gemma 4 models are now enabled by default via the Gemini API, providing improved performance and capabilities out of the box.
• Voice Mode Polish: Added wave animations for visual feedback and privacy/compliance UX warnings specifically for the Gemini Live backend.
• Session Management: Added a --delete flag to the /exit command for instant session deletion and introduced /bug-memory for easier heap diagnostics.
• Improved Reliability: Reduced default API timeouts to 60s and implemented retries for undici and premature stream closure errors.

What's Changed

• fix(cli): prevent automatic updates from switching to less stable channels by @Adib234 in #26132
• chore(release): bump version to 0.42.0-nightly.20260428.g59b2dea0e by @gemini-cli-robot in #26142
• fix(cli): pass node arguments via NODE_OPTIONS during relaunch to support SEA by @cocosheng-g in #26130
• fix(cli): handle DECKPAM keypad Enter sequences in terminal by @Gitanaskhan26 in #26092
• docs(cli): point plan-mode session retention to actual /settings labels by @ifitisit in #25978
• fix(core): add missing oauth fields support in subagent parsing by @abhipatel12 in #26141
• fix(core): disconnect extension-backed MCP clients in stopExtension by @cocosheng-g in #26136
• Update documentation workflows with workspace trust by @g-samroberts in #26150
• refactor(acp): modularize monolithic acpClient into specialized files by @sripasg in #26143
• test: fix failures due to antigravity environment leakage by @adamfweidman in #26162
• fix(core): add explicit empty log guard in A2A pushMessage by @adamfweidman in #26198
• feat(cli): add --delete flag to /exit command for session deletion by @AbdulTawabJuly in #19332
• test(core): add regression test for issue for ToolConfirmationResponse by @Adib234 in #26194
• Add the ability to @ mention the gemini robot. by @gundermanc in #26207
• test(evals): add EvalMetadata JSDoc annotations to older tests by @akh64bit in #26147
• fix(core): reduce default API timeout to 60s and enable retries for undici timeouts by @Adib234 in #26191
• fix(core): distinguish fallback chains and fix maxAttempts for auto vs explicit model selection by @adamfweidman in #26163
• fix(cli): handle InvalidStream event gracefully without throwing by @adamfweidman in #26218
• ci(github-actions): switch to github app token and fix bot self-trigger by @gundermanc in #26223
• Respect logPrompts flag for logging sensitive fields by @lp-peg in #26153
• fix: correct API key validation logic in handleApiKeySubmit by @martin-hsu-test in #25453
• fix(agent): prevent exit_plan_mode from being called via shell by @Abhijit-2592 in #26230

• Fix: Inconsistent Case-Sensitivity in GrepTool by @.github/workflows/gemini-cli-bot-pulse.yml[bot] in #26235

• docs(core): add automated gemma setup guide by @Samee24 in #26233
• Allow non-https proxy urls to support container environments by @stevemk14ebr in #26234
• fix(bot): productivity and backlog optimizations by @gundermanc in #26236
• refactor(acp): delegate prompt turn processing logic to GeminiClient by @sripasg in #26222
• fix(cli): refine platform-specific undo/redo and smart bubbling for WSL by @cocosheng-g in #26202
• fix: suppress duplicate extension warnings during startup by @cocosheng-g in #26208
• fix(cli): use byte length instead of string length for readStdin size limits by @Adib234 in #26224
• fix(ui): made shell tool header wrap on Ctrl+O by @devr0306 in #26229
• Changelog for v0.41.0-preview.0 by @gemini-cli-robot in #26244
• Skip binary CLI relaunch by @ruomengz in #26261
• fix(cli): do not override GOOGLE_CLOUD_PROJECT in Cloud Shell when using Vertex AI by @jackwotherspoon in #24455
• docs(cli): add skill discovery troubleshooting checklist to tutorial by @pmenic in #26018
• docs(policy-engine): link to tools reference for tool names and args by @Aaxhirrr in #22081
• Fix posting invalid response to a comment by @gundermanc in #26266
• fix(cli): prevent informational logs from polluting json output by @cocosheng-g in #26264
• feat(ui): added microphone and updated placeholder for voice mode by @devr0306 in #26270
• feat(cli): Add 'list' subcommand to '/commands' by @Jwhyee in #22324
• fix(core): ensure tool output cleanup on session deletion for legacy files by @cocosheng-g in #26263
• Docs: Update Agent Skills documentation by @jkcinouye in #22388
• test(acp): add missing coverage for extensions command error paths by @sahilkirad in #25313
• Changelog for v0.40.0 by @gemini-cli-robot in #26245
• fix: report AgentExecutionBlocked in non-interactive programmatic modes by @cocosheng-g in #26262
• feat(extensions): add 'delete' as an alias for /extensions uninstall by @martin-hsu-test in #25660
• fix(core): silently skip GEMINI.md paths that are directories (EISDIR) by @martin-hsu-test in #25662
• fix(ci): checkout PR branch instead of main in bot workflow by @gundermanc in #26289
• fix(cli): use resolved sandbox state for auto-update check by @Adib234 in #26285

• Metrics Integrity & Standardized Reporting (BT-01) by @.github/workflows/gemini-cli-bot-pulse.yml[bot] in #26240

• Add Star History section to README by @bdmorgan in #26290
• Add Star History section to README by @bdmorgan in #26308
• Remove Star History section from README by @bdmorgan in #26309
• test(evals): add behavioral eval for file creation and write_file tool selection by @akh64bit in #26292
• feat(config): enable Gemma 4 models by default via Gemini API by @Abhijit-2592 in #26307
• fix(cli): insert voice transcription at cursor position instead of ap… by @Zheyuan-Lin in #26287
• fix(ui): fix issue with box edges by @gundermanc in #26148
• fix(cli): respect .env override for GOOGLE_CLOUD_PROJECT by @DavidAPierce in #26288
• fix(ci): robust version checking in release verification by @scidomino in #26337
• fix(cli): enable daemon relaunch in binary and bundle keytar by @ruomengz in #26333
• fix(core): discourage unprompted git add . in prompt snippets by @akh64bit in #26220
• feat(ui): added wave animation for voice mode by @devr0306 in #26284
• fix(cli): prevent Escape from clearing input buffer (#17083) by @cocosheng-g in #26339
• fix(cli): undeprecate --prompt and correct positional query docs by @Adib234 in #26329
• Metrics updates by @.github/workflows/gemini-cli-bot-pulse.yml[bot] in #26348
• fix(core): remove "System: Please continue." injection on InvalidStream events by @SandyTao520 in #26340
• docs(policy-engine): add tool argument keys reference and shell policy cross-links by @harshpujari in #25292
• fix(cli): resolve Ghostty/raw-mode False Cancellation in oauth flow by @Aarchi-07 in #25026
• fix(core): reset session-scoped state on resumption by @cocosheng-g in #26342
• Fix bulk of remaining issues with generalist profile by @joshualitt in #26073
• fix(core): make subagents aware of active approval modes by @akh64bit in #23608
• fix(acp): resolve agent mode disconnect and improve mode awareness by @sripasg in #26332
• docs(sdk): add JSDoc to exported interfaces in packages/sdk/src/types.ts by @cocosheng-g in #26441
• perf: skip redundant GEMINI.md loading in partialConfig by @cocosheng-g in #26443
• Enhance React guidelines by @psinha40898 in #22667
• feat(core): reinforce Inquiry constraints to prevent unauthorized changes by @akh64bit in #26310
• revert: fix(ci): robust version checking in release verification (#26337) by @scidomino in #26450
• refactor(UI): created constants file for ThemeDialog by @devr0306 in #26446
• docs: fix GitHub capitalization in releases guide by @haosenwang1018 in #26379
• fix(cli): ensure branch indicator updates in sub-directories and worktrees by @Adib234 in #26330
• feat: add minimal V8 heap snapshot utility for memory diagnostics by @cocosheng-g in #26440
• fix(hooks): preserve non-text parts in fromHookLLMRequest by @SandyTao520 in #26275
• fix(cli): allow early stdout when config is undefined by @cocosheng-g in #26453
• fix(cli)#21297: clear skills consent dialog before reload by @manavmax in #26431
• fix(cli): render LaTeX-style output as Unicode in the TUI by @dimssu in #25802
• fix(core): use close event instead of exit in child_process fallback by @tusaryan in #25695
• feat(voice): add privacy and compliance UX warning for Gemini Live backend by @cocosheng-g in #26454
• feat(memory): add Auto Memory inbox flow with canonical-patch contract by @SandyTao520 in #26338
• test(cleanup): fix temporary directory leaks in test suites by @Adib234 in #26217
• feat: add ignoreLocalEnv setting and --ignore-env flag (#2493) by @cocosheng-g in #26445
• docs(sdk): add JSDoc to all exported interfaces and types by @fauzan171 in #26277
• feat(cli): improve /agents refresh logging by @cocosheng-g in #26442
• Fix: make Dockerfile self-contained with multi-stage build by @Famous077 in #24277
• fix(core): filter unsupported multimodal types from tool responses by @aishaneeshah in #26352
• fix(core): properly format markdown in AskUser tool by unescaping newlines by @Adib234 in #26349
• feat(bot): add actions spend metric script by @gundermanc in #26463
• feat(cli): add /bug-memory command and auto-capture heap snapshot in /bug by @Anjaligarhwal in #25639
• fix(cli): make SkillInboxDialog fit and scroll in alternate buffer by @SandyTao520 in #26455
• Robust Scale-Safe Lifecycle Consolidation by @gemini-cli-robot in #26355
• fix(ci): respect exempt labels when closing stale items by @gundermanc in #26475
• fix(cli): use os.homedir() for home directory warning check by @TirthNaik-99 in #25890
• fix(a2a-server): resolve tool approval race condition and improve status reporting by @kschaab in #26479
• fix(cli): prevent settings dialog border clipping using maxHeight by @jackwotherspoon in #26507
• feat: allow queuing messages during compression (#24071) by @cocosheng-g in #26506
• fix(core): retry on ERR_STREAM_PREMATURE_CLOSE errors by @cocosheng-g in #26519
• fix(core): Minor fixes for generalist profile. by @joshualitt in #26357
• fix(patch): cherry-pick 3627f47 to release/v0.42.0-preview.0-pr-26542 to patch version v0.42.0-preview.0 and create version 0.42.0-preview.1 by @gemini-cli-robot in #26544
• fix(patch): cherry-pick 02995ba to release/v0.42.0-preview.1-pr-26568 to patch version v0.42.0-preview.1 and create version 0.42.0-preview.2 by @gemini-cli-robot in #26590

Full Changelog: https://github.com/google-gemini/gemini-cli/compare/v0.41.2...v0.42.0