Gemini CLI v0.62.0: Gemini 3.8 Flash, 3.5 Flash Lite, OAuth and PTY fixes#
Published by Alex Sorokoletov
Part of the Gemini CLI Version Tracker series. | Gemini CLI on GitHub | Releases
Gemini CLI v0.62.0 follows v0.61.0. It adds the Gemini 3.8 Flash and 3.5 Flash Lite models, retains the stored OAuth refresh token when a refresh response comes back partial so you stay signed in, hardens shell execution and Windows ConPTY lifecycle handling, and stops the terminal-border renderer from breaking on negative or non-finite dimensions.[1]
New models#
v0.62.0 adds the Gemini 3.8 Flash and 3.5 Flash Lite models to the CLI, registering gemini-3.8-flash and gemini-3.5-flash-lite as selectable model targets in the default model configuration.[7]
Staying signed in#
The auth fix is the one most users will feel. When a token refresh returned a response that omitted fields, the stored credential could be overwritten with the gaps, which meant the stored credential could lose its refresh token and the next session would ask you to log in again. v0.62.0 falls back to the existing stored credential when the refresh response omits fields, and makes credential deletion idempotent so a repeated delete no longer errors.[2] The practical result is fewer surprise re-authentication prompts across long-running sessions.
Reliability fixes#
The rest of the release is cross-platform reliability work, weighted toward Windows shell handling and the terminal UI.
| Area | What changed |
|---|---|
| Shell / PTY | PTY file-descriptor cleanup and execution-lifecycle management improved; on Windows, ConPTY process-exit lifecycle is synchronized and PTY output finalization is hardened.[3] |
| Terminal buffers | Terminal buffer memory management improved and Windows diagnostic paths are formatted correctly in output.[3] |
| Border rendering | Border widths are guarded against negative, NaN, fractional, and non-finite values, returning an empty string instead of throwing on a bad layout dimension.[4] |
| ACP / MCP | In ACP mode the tool_call update is emitted before request_permission, and MCP tool-call titles render as structured signatures with their explanations separated out.[5] |
| VS Code companion | Terminal focus is preserved when a diff tab is closed.[6] |
| Proxy | proxy-agent interop is normalized so environment proxy settings resolve through the bundled build.[6] |
The border-rendering change adds a small guard that repeats a border character only for a finite, non-negative count and otherwise returns nothing, so a terminal that reports a negative or zero width during a resize renders an empty border rather than crashing the layout.[4] The ACP and MCP tweaks target editor integrations driving the CLI over the Agent Client Protocol: emitting the tool call before the permission request gives the host a chance to show what is about to run, and the structured tool-call titles make MCP calls readable in that surface.
What this tells us#
v0.62.0 adds the Gemini 3.8 Flash and 3.5 Flash Lite models and fixes several reliability issues: auth dropped on a partial refresh, PTY file descriptors leaked during shell execution, the TUI could miscompute a border width, and the editor integration stole terminal focus. The Windows-specific ConPTY and diagnostic-path work stands out, since terminal handling on Windows is where a cross-platform agent tends to accumulate the most rough edges.
For Gemini CLI specifically, the continued investment in ACP and the VS Code companion is the throughline worth watching, because that is the path by which the CLI becomes the engine behind an editor rather than only a standalone terminal tool. v0.62.0 adds Gemini 3.8 Flash and 3.5 Flash Lite and steadies daily use on Windows and through an editor.
Sources#
- [1] Gemini CLI v0.62.0 release notes (v0.61.0 to v0.62.0)
- [2] PR #29339: retain oauth refresh token on refresh and make credential deletion idempotent
- [3] PR #29340: PTY file descriptor cleanup and execution lifecycle, PR #29379: synchronize ConPTY process exit lifecycle, PR #29380: terminal buffer memory management and Windows diagnostic paths
- [4] PR #29347: guard against negative layout dimensions in border rendering
- [5] PR #29439: emit tool_call update prior to request_permission in ACP mode, PR #29341: format MCP tool call titles as structured signatures
- [6] PR #29378: preserve terminal focus when closing diff tabs, PR #29401: normalize proxy-agent esbuild interop for environment proxy resolution
- [7] PR #29443: add Gemini 3.8 Flash and 3.5 Flash Lite
This analysis is based on publicly available open-source code and release metadata, conducted for educational and research purposes. All trademarks and software referenced belong to their respective owners.
Previous Gemini CLI analysis: v0.61.0 (September 26, 2026)
All 4 Gemini CLI analyses: Gemini CLI Version Tracker · Official Gemini CLI changelog