Tools / Gemini CLI / v0.69.0

Gemini CLI v0.69.0 release notes & breaking changes

model

Gemini CLI v0.69.0 is a Google release published 2026-11-19 with 33 listed changes. Summary and full notes below, extracted from the official notes.

Get breaking changes for Gemini CLI in your inbox every Monday

One free email: every breaking change, retirement and price change across 23 coding agents. No spam, unsubscribe anytime.

Subscribe free

← All Gemini CLI releases and breaking changes

Summary

Full notes

## What's Changed
* fix(core,cli): preserve literal `$` characters during template placeholder replacement by @jesussamuel-byte in https://github.com/google-gemini/gemini-cli/pull/30136
* feat(cli): add /stats heatmap subcommand for daily token usage by @jvargassanchez-dot in https://github.com/google-gemini/gemini-cli/pull/30135
* fix(core): prevent __GCLI_EXPAND_TARGET__ env collision in expandEnvVars by @villahernandez-coder in https://github.com/google-gemini/gemini-cli/pull/30138
* chore(release): bump version to 0.69.0-nightly.20261104.g89e9d25d6 by @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/30140
* fix(cli): serialize AnsiOutput to text content in ACP tool call updates by @diegogodinezr in https://github.com/google-gemini/gemini-cli/pull/30141
* Changelog for v0.67.0 by @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/30145
* Changelog for v0.68.0-preview.0 by @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/30146
* fix(core): fix Windows PowerShell substitution false positives and policy handling by @duvanka-prasad in https://github.com/google-gemini/gemini-cli/pull/30110
* fix(cli): preserve leading and trailing whitespace in @file references by @duvanka-prasad in https://github.com/google-gemini/gemini-cli/pull/30150
* fix(core): prevent thoughtSignature-only turns and preserve multimodal tool responses  by @tadipavan in https://github.com/google-gemini/gemini-cli/pull/30153
* fix(cli): wait for piped stdin EOF and avoid destroying process.stdin by @villahernandez-coder in https://github.com/google-gemini/gemini-cli/pull/30163
* fix(cli): preserve pending tool confirmation when escaping editor selection by @jvargassanchez-dot in https://github.com/google-gemini/gemini-cli/pull/30147
* feat(cli): support standalone theme.json configuration for custom themes by @jesussamuel-byte in https://github.com/google-gemini/gemini-cli/pull/30119
* fix(cli): normalize error payloads in headless CLI formatting by @jvargassanchez-dot in https://github.com/google-gemini/gemini-cli/pull/30117
* fix(core): require path-separator boundary in tildeifyPath by @villahernandez-coder in https://github.com/google-gemini/gemini-cli/pull/30124
* fix(cli): validate model names and support direct arguments in /model command by @jesussamuel-byte in https://github.com/google-gemini/gemini-cli/pull/30137
* fix(cli): handle file watcher errors and permit FSEvents in macOS permissive sandbox by @diegogodinezr in https://github.com/google-gemini/gemini-cli/pull/30143
* fix(core): bound multi-part tool outputs and evict older multimodal inlineData by @tadipavan in https://github.com/google-gemini/gemini-cli/pull/30180
* fix(vscode): eliminate barrel import bundle bloat and redundant setContext calls by @ugorla-dev in https://github.com/google-gemini/gemini-cli/pull/30181
* fix(acp): handle mid-stream retries to prevent text concatenation by @urielefrenvirtusa in https://github.com/google-gemini/gemini-cli/pull/30165
* fix(core,cli): prevent silent multi-minute loading hangs on network failures by @villahernandez-coder in https://github.com/google-gemini/gemini-cli/pull/30182
* fix(core,cli): prevent terminal model-turn 400s on resume and main-thread JSONL freezes by @villahernandez-coder in https://github.com/google-gemini/gemini-cli/pull/30186
* fix(core): prevent multi-hour quota retries and notify ACP client on retry attempts by @urielefrenvirtusa in https://github.com/google-gemini/gemini-cli/pull/30187
* fix(core): close orphan /dev/ptmx master FD leaked on macOS PTY spawn by @ugorla-dev in https://github.com/google-gemini/gemini-cli/pull/30184
* fix(core,cli): allow overriding 60s API headers timeout across all auth modes (`model.requestTimeoutMs` / `GEMINI_API_HEADERS_TIMEOUT_MS`) by @jesussamuel-byte in https://github.com/google-gemini/gemini-cli/pull/30183
* fix(cli): use isSubpath for theme file home-directory check by @duvanka-prasad in https://github.com/google-gemini/gemini-cli/pull/30160
* fix(cli): resolve folder trust before entering the macOS Seatbelt sandbox by @diegogodinezr in https://github.com/google-gemini/gemini-cli/pull/30164
* fix(cli,core): kill child processes, record cancelled tools, and preserve signal exit code on headless abort by @duvanka-prasad in https://github.com/google-gemini/gemini-cli/pull/30204
* fix(cli): prevent recursive interactive gemini sessions in shell mode by @jvargassanchez-dot in https://github.com/google-gemini/gemini-cli/pull/30185
* fix(core): reject MessageBus.request() immediately when publish fails by @luisfelipe-alt in https://github.com/google-gemini/gemini-cli/pull/30189
* fix(core): ensure read-many-files only inlines explicitly requested binary assets (#29045) by @urielefrenvirtusa in https://github.com/google-gemini/gemini-cli/pull/30211
* fix(core): recognize TortoiseGitPlink as PuTTY-family SSH client (#29917) by @urielefrenvirtusa in https://github.com/google-gemini/gemini-cli/pull/30214
* fix(core): prevent PDF inlineData and telemetry buffer memory retention by @tadipavan in https://github.com/google-gemini/gemini-cli/pull/30217


**Full Changelog**: https://github.com/google-gemini/gemini-cli/compare/v0.68.0...v0.69.0
← Older: v0.68.0 (2026-11-10)Newer: v0.70.0 (2026-11-19)
Weekly digest: every breaking change, retirement and price change across 23 coding agents, one email.

Form not loading? Subscribe here.