gemini-cli-leo 0.1.29-fix-1 → 0.1.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -18,6 +18,24 @@ on GitHub.
18
18
  | [Preview](preview.md) | Experimental features ready for early feedback. |
19
19
  | [Stable](latest.md) | Stable, recommended for general use. |
20
20
 
21
+ ## Announcements: v0.67.0 - 2026-11-04
22
+
23
+ - **Model Discovery Command:** Added a new `models` command and `--list-models`
24
+ flag for discovering available models directly from the CLI
25
+ ([#29880](https://github.com/google-gemini/gemini-cli/pull/29880) by
26
+ @urielefrenvirtusa).
27
+ - **Container Sandbox IDE Bridging:** Enabled bridging the IDE companion into
28
+ container sandboxes over exec stdio to improve IDE integration in
29
+ containerized environments
30
+ ([#29858](https://github.com/google-gemini/gemini-cli/pull/29858) by
31
+ @elberthc-byte).
32
+ - **Cancellation & Signal Resilience:** Improved termination signal handling and
33
+ prevented post-cancellation tool execution and continuation stream processing
34
+ ([#29849](https://github.com/google-gemini/gemini-cli/pull/29849) by
35
+ @urielefrenvirtusa,
36
+ [#29868](https://github.com/google-gemini/gemini-cli/pull/29868) by
37
+ @jesussamuel-byte).
38
+
21
39
  ## Announcements: v0.66.0 - 2026-10-27
22
40
 
23
41
  - **Terminal UI Rendering & Flicker Prevention:** Implemented synchronized
@@ -1,6 +1,6 @@
1
- # Latest stable release: v0.66.0
1
+ # Latest stable release: v0.67.0
2
2
 
3
- Released: October 27, 2026
3
+ Released: November 4, 2026
4
4
 
5
5
  For most users, our latest stable release is the recommended release. Install
6
6
  the latest stable version with:
@@ -11,96 +11,101 @@ npm install -g @google/gemini-cli
11
11
 
12
12
  ## Highlights
13
13
 
14
- - **Terminal UI & Display Rendering:** Implemented synchronized terminal output
15
- mode, isolated spinner rendering, and preserved scrollback buffers across
16
- viewport refreshes while eliminating buffer flickering and border bleed in
17
- scrollable tool containers.
18
- - **Execution Scheduling & Process Lifecycle:** Refactored the core scheduler to
19
- emit tool call groups directly and eliminated UI lookahead, while ensuring
20
- process termination signals forward reliably from bootstrap wrappers to child
21
- processes.
22
- - **Git & Shell Environment Robustness:** Preserved user-level `~/.gitconfig`
23
- settings in shell and git environments, suppressed interactive SSH and
24
- credential prompts to avoid execution hangs, and improved Windows diff
25
- argument quoting.
26
- - **Security & Configuration Management:** Added opt-in support for private
27
- network endpoints during MCP OAuth flows, eliminated false positives in
28
- authentication error detection, resolved settings placeholders after loading
29
- `.env` files, and added `keys` array support for custom keybindings.
14
+ - **Model Discovery Command & Flag**: Added a new `models` command and
15
+ `--list-models` flag for model discovery directly from the CLI.
16
+ - **Container Sandbox IDE Bridging**: Bridged the IDE companion into container
17
+ sandboxes over exec stdio to improve IDE integration in containerized
18
+ environments.
19
+ - **Cancellation & Signal Resilience**: Improved termination signal and
20
+ cancellation handling by stopping continuation stream processing, halting
21
+ auto-nudges, and preventing subsequent tool execution in non-interactive mode.
22
+ - **Terminal Rendering & Unicode Support**: Refined character width calculation
23
+ for terminals rendering ambiguous-width characters and corrected display width
24
+ for Thai and Lao SARA AM scripts.
25
+ - **Filesystem & Security Safeguards**: Hardened atomic file writing to respect
26
+ read-only files and hard links, resolved relative file paths against the
27
+ active IDE workspace root, scoped untrusted flag checks to external output,
28
+ and included MCP server and tool metadata in permission requests.
30
29
 
31
30
  ## What's Changed
32
31
 
33
- - Update ROADMAP.md to no longer reference outdated 2025 roadmap by
34
- @DavidAPierce in
35
- [#29723](https://github.com/google-gemini/gemini-cli/pull/29723)
36
- - Changelog for v0.65.0-preview.0 by @gemini-cli-robot in
37
- [#29739](https://github.com/google-gemini/gemini-cli/pull/29739)
38
- - chore(release): bump version to 0.66.0-nightly.20261013.g204db94ae by
32
+ - Changelog for v0.65.0 by @gemini-cli-robot in
33
+ [#29853](https://github.com/google-gemini/gemini-cli/pull/29853)
34
+ - chore(release): bump version to 0.67.0-nightly.20261020.gb041de017 by
39
35
  @gemini-cli-robot in
40
- [#29740](https://github.com/google-gemini/gemini-cli/pull/29740)
41
- - Changelog for v0.64.0 by @gemini-cli-robot in
42
- [#29741](https://github.com/google-gemini/gemini-cli/pull/29741)
43
- - fix(ui): implement synchronized output and isolate spinner rendering by
44
- @diegogodinezr in
45
- [#29725](https://github.com/google-gemini/gemini-cli/pull/29725)
46
- - fix(ui): fix debug console height calculation and terminalBuffer flickering by
47
- @ugorla-dev in
48
- [#29695](https://github.com/google-gemini/gemini-cli/pull/29695)
49
- - fix(cli): prevent right-hand border bleed in scrollable tool containers by
50
- @villahernandez-coder in
51
- [#29742](https://github.com/google-gemini/gemini-cli/pull/29742)
52
- - refactor(core,cli): emit tool call groups from the scheduler and drop the UI
53
- lookahead by @jesussamuel-byte in
54
- [#29736](https://github.com/google-gemini/gemini-cli/pull/29736)
55
- - fix(core): format and quote Windows diff command arguments in openDiff by
56
- @jvargassanchez-dot in
57
- [#29753](https://github.com/google-gemini/gemini-cli/pull/29753)
58
- - fix(cli): round before selecting units in formatDuration by @diegogodinezr in
59
- [#29766](https://github.com/google-gemini/gemini-cli/pull/29766)
60
- - fix(core): disable interactive credential and SSH prompts in getSafeGitEnv by
36
+ [#29854](https://github.com/google-gemini/gemini-cli/pull/29854)
37
+ - Changelog for v0.66.0-preview.0 by @gemini-cli-robot in
38
+ [#29852](https://github.com/google-gemini/gemini-cli/pull/29852)
39
+ - feat(cli): bridge the IDE companion into container sandboxes over exec stdio
40
+ by @elberthc-byte in
41
+ [#29858](https://github.com/google-gemini/gemini-cli/pull/29858)
42
+ - fix(core): prevent duplicate agent loading when workspace is home directory
43
+ (#27692) by @urielefrenvirtusa in
44
+ [#29847](https://github.com/google-gemini/gemini-cli/pull/29847)
45
+ - fix(ide): exclude IDE settings and GEMINI.md files from open file con text by
61
46
  @villahernandez-coder in
62
- [#29760](https://github.com/google-gemini/gemini-cli/pull/29760)
63
- - fix(cli): resolve settings placeholders after loading .env files by
64
- @elberthc-byte in
65
- [#29750](https://github.com/google-gemini/gemini-cli/pull/29750)
66
- - fix(core): harden SKILL.md frontmatter parsing for single-line descriptions by
47
+ [#29848](https://github.com/google-gemini/gemini-cli/pull/29848)
48
+ - fix(core): scope untrusted flag checks to external output and remember
49
+ approved flags by @luisfelipe-alt in
50
+ [#29833](https://github.com/google-gemini/gemini-cli/pull/29833)
51
+ - fix(a2a-server): mount express.json() before A2A SDK route registration by
67
52
  @jesussamuel-byte in
68
- [#29769](https://github.com/google-gemini/gemini-cli/pull/29769)
69
- - Add Banner about Gemini CLI not being optimized for Gemini 4 by @srithreepo in
70
- [#29774](https://github.com/google-gemini/gemini-cli/pull/29774)
71
- - Update README to remove obsolete content by @srithreepo in
72
- [#29775](https://github.com/google-gemini/gemini-cli/pull/29775)
73
- - fix(ci): remove unsupported members permission in unassign-inactive-assignees
74
- workflow by @ugorla-dev in
75
- [#29770](https://github.com/google-gemini/gemini-cli/pull/29770)
76
- - fix(cli): reset slash-command conflict dedupe when conflicts reappear by
77
- @jvargassanchez-dot in
78
- [#29768](https://github.com/google-gemini/gemini-cli/pull/29768)
79
- - fix(cli): verify active binary update to prevent PATH shadowing false success
80
- by @urielefrenvirtusa in
81
- [#29757](https://github.com/google-gemini/gemini-cli/pull/29757)
82
- - fix(cli): support 'keys' array in keybindings.json by @urielefrenvirtusa in
83
- [#29773](https://github.com/google-gemini/gemini-cli/pull/29773)
84
- - fix(cli): forward termination signals from bootstrap parent to child process
85
- by @villahernandez-coder in
86
- [#29790](https://github.com/google-gemini/gemini-cli/pull/29790)
87
- - fix(ui): preserve terminal scrollback during viewport refreshes by
53
+ [#29850](https://github.com/google-gemini/gemini-cli/pull/29850)
54
+ - fix(core): adhere to RFC 9110 token rules when splitting custom headers by
88
55
  @diegogodinezr in
89
- [#29792](https://github.com/google-gemini/gemini-cli/pull/29792)
90
- - fix(cli): decode streamed Node HTTP activity chunks with StringDecoder by
91
- @jesussamuel-byte in
92
- [#29827](https://github.com/google-gemini/gemini-cli/pull/29827)
93
- - chore: migrate gsutil usage to gcloud storage by @gurusai-voleti in
94
- [#29839](https://github.com/google-gemini/gemini-cli/pull/29839)
95
- - fix(core): preserve user-level ~/.gitconfig in shell and git environments by
56
+ [#29865](https://github.com/google-gemini/gemini-cli/pull/29865)
57
+ - fix(core): respect read-only files and hard links in atomic writeTextFile by
58
+ @elberthc-byte in
59
+ [#29749](https://github.com/google-gemini/gemini-cli/pull/29749)
60
+ - fix(a2a-server,core): preserve extended token usage metadata and align
61
+ per-turn reporting by @jvargassanchez-dot in
62
+ [#29834](https://github.com/google-gemini/gemini-cli/pull/29834)
63
+ - fix(core): ensure all model turns with function calls receive thought
64
+ signatures by @amelidev in
65
+ [#29828](https://github.com/google-gemini/gemini-cli/pull/29828)
66
+ - fix(cli): handle termination signals and prevent tool execution after
67
+ cancellation in non-interactive mode by @urielefrenvirtusa in
68
+ [#29849](https://github.com/google-gemini/gemini-cli/pull/29849)
69
+ - fix(cli): preserve ${VAR} placeholders during deprecated settings migration by
70
+ @villahernandez-coder in
71
+ [#29867](https://github.com/google-gemini/gemini-cli/pull/29867)
72
+ - fix(cli): stop continuation stream processing and auto-nudge after request
73
+ cancellation by @jesussamuel-byte in
74
+ [#29868](https://github.com/google-gemini/gemini-cli/pull/29868)
75
+ - fix(cli): correct Thai and Lao SARA AM display width by @elberthc-byte in
76
+ [#29883](https://github.com/google-gemini/gemini-cli/pull/29883)
77
+ - fix(core): resolve relative file paths against active IDE workspace root by
78
+ @villahernandez-coder in
79
+ [#29838](https://github.com/google-gemini/gemini-cli/pull/29838)
80
+ - feat(cli): add models command and --list-models flag for model discovery by
81
+ @urielefrenvirtusa in
82
+ [#29880](https://github.com/google-gemini/gemini-cli/pull/29880)
83
+ - fix(cli): convert Claude hook timeout from seconds to milliseconds during
84
+ migration by @villahernandez-coder in
85
+ [#29899](https://github.com/google-gemini/gemini-cli/pull/29899)
86
+ - fix(core): classify project spending cap errors as terminal quota errors by
96
87
  @jesussamuel-byte in
97
- [#29832](https://github.com/google-gemini/gemini-cli/pull/29832)
98
- - fix(core): prevent false positive matches in isAuthenticationError by
88
+ [#29961](https://github.com/google-gemini/gemini-cli/pull/29961)
89
+ - fix(acp): include MCP server and tool metadata in permission requests by
90
+ @duvanka-prasad in
91
+ [#29910](https://github.com/google-gemini/gemini-cli/pull/29910)
92
+ - fix(cli): prevent parent command name insertion on /chat list autocomplete by
99
93
  @urielefrenvirtusa in
100
- [#29835](https://github.com/google-gemini/gemini-cli/pull/29835)
101
- - fix(core): support opt-in private network endpoints for MCP OAuth flows by
102
- @luisfelipe-alt in
103
- [#29844](https://github.com/google-gemini/gemini-cli/pull/29844)
94
+ [#29967](https://github.com/google-gemini/gemini-cli/pull/29967)
95
+ - fix(cli): validate finite numbers in numeric settings editor by @diegogodinezr
96
+ in [#29968](https://github.com/google-gemini/gemini-cli/pull/29968)
97
+ - fix(core): allow trusted system paths on Android (Termux) for ripgrep
98
+ resolution (#21836) by @amelidev in
99
+ [#29884](https://github.com/google-gemini/gemini-cli/pull/29884)
100
+ - fix(core): normalize CRLF line endings before diffing in getDiffContextSnippet
101
+ by @jesussamuel-byte in
102
+ [#29966](https://github.com/google-gemini/gemini-cli/pull/29966)
103
+ - fix(cli): handle terminals that render ambiguous-width characters as wide by
104
+ @elberthc-byte in
105
+ [#29905](https://github.com/google-gemini/gemini-cli/pull/29905)
106
+ - fix(cli): prevent duplicate history and double telemetry in confirm_action
107
+ flow by @duvanka-prasad in
108
+ [#29974](https://github.com/google-gemini/gemini-cli/pull/29974)
104
109
 
105
110
  **Full Changelog**:
106
- https://github.com/google-gemini/gemini-cli/compare/v0.65.0...v0.66.0
111
+ https://github.com/google-gemini/gemini-cli/compare/v0.66.0...v0.67.0
@@ -1,6 +1,6 @@
1
- # Preview release: v0.67.0-preview.0
1
+ # Preview release: v0.68.0-preview.0
2
2
 
3
- Released: October 27, 2026
3
+ Released: November 4, 2026
4
4
 
5
5
  Our preview release includes the latest, new, and experimental features. This
6
6
  release may not be as stable as our [latest weekly release](latest.md).
@@ -13,101 +13,115 @@ npm install -g @google/gemini-cli@preview
13
13
 
14
14
  ## Highlights
15
15
 
16
- - **Model Discovery Command & Flag**: Added a new `models` command and
17
- `--list-models` flag for model discovery directly from the CLI.
18
- - **Container Sandbox IDE Bridging**: Bridged the IDE companion into container
19
- sandboxes over exec stdio to improve IDE integration in containerized
20
- environments.
21
- - **Cancellation & Signal Resilience**: Improved termination signal and
22
- cancellation handling by stopping continuation stream processing, halting
23
- auto-nudges, and preventing subsequent tool execution in non-interactive mode.
24
- - **Terminal Rendering & Unicode Support**: Refined character width calculation
25
- for terminals rendering ambiguous-width characters and corrected display width
26
- for Thai and Lao SARA AM scripts.
27
- - **Filesystem & Security Safeguards**: Hardened atomic file writing to respect
28
- read-only files and hard links, resolved relative file paths against the
29
- active IDE workspace root, scoped untrusted flag checks to external output,
30
- and included MCP server and tool metadata in permission requests.
16
+ - **Extension Validation & Installation Reliability**: Added an extension
17
+ validation command, serialized concurrent extension installations with a
18
+ per-extension lock, and handled stream interruptions during extension
19
+ downloads.
20
+ - **Model Selection & Dynamic Resolution**: Preserved user-selected models
21
+ across transient fallbacks, cancellations, and rewind operations, ensured
22
+ explicit Gemini models are retained during dynamic resolution, and refined
23
+ model listings when dynamic configuration is active.
24
+ - **UI Responsiveness & Rate Limit Feedback**: Surfaced 429 rate limit cooldown
25
+ and countdown status directly in the loading indicator, bounded history
26
+ re-renders when terminal width changes, and resolved truncation and toggling
27
+ issues in expandable views.
28
+ - **Environment & Platform Compatibility**: Enabled rootless Podman execution
29
+ with user namespace mapping, honored git exclude configurations in shadow
30
+ repositories, and improved Windows filesystem compatibility across path checks
31
+ and process lookups.
32
+ - **Hooks & Agent Lifecycle Events**: Added support for mapping SubagentStop
33
+ hook events, merged hook definitions cleanly, and ensured history replays
34
+ complete before responding to ACP session load requests.
31
35
 
32
36
  ## What's Changed
33
37
 
34
- - Changelog for v0.65.0 by @gemini-cli-robot in
35
- [#29853](https://github.com/google-gemini/gemini-cli/pull/29853)
36
- - chore(release): bump version to 0.67.0-nightly.20261020.gb041de017 by
37
- @gemini-cli-robot in
38
- [#29854](https://github.com/google-gemini/gemini-cli/pull/29854)
39
- - Changelog for v0.66.0-preview.0 by @gemini-cli-robot in
40
- [#29852](https://github.com/google-gemini/gemini-cli/pull/29852)
41
- - feat(cli): bridge the IDE companion into container sandboxes over exec stdio
42
- by @elberthc-byte in
43
- [#29858](https://github.com/google-gemini/gemini-cli/pull/29858)
44
- - fix(core): prevent duplicate agent loading when workspace is home directory
45
- (#27692) by @urielefrenvirtusa in
46
- [#29847](https://github.com/google-gemini/gemini-cli/pull/29847)
47
- - fix(ide): exclude IDE settings and GEMINI.md files from open file con text by
48
- @villahernandez-coder in
49
- [#29848](https://github.com/google-gemini/gemini-cli/pull/29848)
50
- - fix(core): scope untrusted flag checks to external output and remember
51
- approved flags by @luisfelipe-alt in
52
- [#29833](https://github.com/google-gemini/gemini-cli/pull/29833)
53
- - fix(a2a-server): mount express.json() before A2A SDK route registration by
54
- @jesussamuel-byte in
55
- [#29850](https://github.com/google-gemini/gemini-cli/pull/29850)
56
- - fix(core): adhere to RFC 9110 token rules when splitting custom headers by
38
+ - Changelog for v0.67.0-preview.0 by @gemini-cli-robot in
39
+ [#29990](https://github.com/google-gemini/gemini-cli/pull/29990)
40
+ - Changelog for v0.66.0 by @gemini-cli-robot in
41
+ [#29992](https://github.com/google-gemini/gemini-cli/pull/29992)
42
+ - docs(readme): clarify Gemini CLI scope, limitations, and tool landscape by
43
+ @LyalinDotCom in
44
+ [#29995](https://github.com/google-gemini/gemini-cli/pull/29995)
45
+ - fix(cli): bound inline history re-render after terminal width changes by
46
+ @jvargassanchez-dot in
47
+ [#29904](https://github.com/google-gemini/gemini-cli/pull/29904)
48
+ - fix(ui): handle surrogate pairs when truncating in sanitizeForDisplay by
57
49
  @diegogodinezr in
58
- [#29865](https://github.com/google-gemini/gemini-cli/pull/29865)
59
- - fix(core): respect read-only files and hard links in atomic writeTextFile by
60
- @elberthc-byte in
61
- [#29749](https://github.com/google-gemini/gemini-cli/pull/29749)
62
- - fix(a2a-server,core): preserve extended token usage metadata and align
63
- per-turn reporting by @jvargassanchez-dot in
64
- [#29834](https://github.com/google-gemini/gemini-cli/pull/29834)
65
- - fix(core): ensure all model turns with function calls receive thought
66
- signatures by @amelidev in
67
- [#29828](https://github.com/google-gemini/gemini-cli/pull/29828)
68
- - fix(cli): handle termination signals and prevent tool execution after
69
- cancellation in non-interactive mode by @urielefrenvirtusa in
70
- [#29849](https://github.com/google-gemini/gemini-cli/pull/29849)
71
- - fix(cli): preserve ${VAR} placeholders during deprecated settings migration by
72
- @villahernandez-coder in
73
- [#29867](https://github.com/google-gemini/gemini-cli/pull/29867)
74
- - fix(cli): stop continuation stream processing and auto-nudge after request
75
- cancellation by @jesussamuel-byte in
76
- [#29868](https://github.com/google-gemini/gemini-cli/pull/29868)
77
- - fix(cli): correct Thai and Lao SARA AM display width by @elberthc-byte in
78
- [#29883](https://github.com/google-gemini/gemini-cli/pull/29883)
79
- - fix(core): resolve relative file paths against active IDE workspace root by
80
- @villahernandez-coder in
81
- [#29838](https://github.com/google-gemini/gemini-cli/pull/29838)
82
- - feat(cli): add models command and --list-models flag for model discovery by
83
- @urielefrenvirtusa in
84
- [#29880](https://github.com/google-gemini/gemini-cli/pull/29880)
85
- - fix(cli): convert Claude hook timeout from seconds to milliseconds during
86
- migration by @villahernandez-coder in
87
- [#29899](https://github.com/google-gemini/gemini-cli/pull/29899)
88
- - fix(core): classify project spending cap errors as terminal quota errors by
89
- @jesussamuel-byte in
90
- [#29961](https://github.com/google-gemini/gemini-cli/pull/29961)
91
- - fix(acp): include MCP server and tool metadata in permission requests by
50
+ [#29993](https://github.com/google-gemini/gemini-cli/pull/29993)
51
+ - fix(core): make isWithinRoot case-insensitive on Windows by @duvanka-prasad in
52
+ [#29999](https://github.com/google-gemini/gemini-cli/pull/29999)
53
+ - fix(core): recognize dotted Gemini 3 models in
54
+ supportsMultimodalFunctionResponse by @jesussamuel-byte in
55
+ [#29982](https://github.com/google-gemini/gemini-cli/pull/29982)
56
+ - feat(cli): add extension validation command and evaluation tests by @tadipavan
57
+ in [#29980](https://github.com/google-gemini/gemini-cli/pull/29980)
58
+ - fix(core): normalize leading slashes in file search query for @ autocomplete
59
+ by @urielefrenvirtusa in
60
+ [#29987](https://github.com/google-gemini/gemini-cli/pull/29987)
61
+ - fix(vscode-ide-companion): register all extension disposables in
62
+ context.subscriptions by @jvargassanchez-dot in
63
+ [#29994](https://github.com/google-gemini/gemini-cli/pull/29994)
64
+ - fix(core): list Auto in /model when dynamicModelConfiguration is enabled and
65
+ preview access is disabled by @villahernandez-coder in
66
+ [#29998](https://github.com/google-gemini/gemini-cli/pull/29998)
67
+ - fix(core,cli): fix instances of incorrect \n escape behavior by @ugorla-dev in
68
+ [#29989](https://github.com/google-gemini/gemini-cli/pull/29989)
69
+ - fix(core): use PowerShell CIM fallback for Windows IDE process lookup by
70
+ @tadipavan in [#30006](https://github.com/google-gemini/gemini-cli/pull/30006)
71
+ - fix(cli): surface 429 rate limit cool-down and countdown in loading indicator
72
+ by @urielefrenvirtusa in
73
+ [#30012](https://github.com/google-gemini/gemini-cli/pull/30012)
74
+ - fix(cli): anchor .git suffix removal to end of repo URL by @diegogodinezr in
75
+ [#30013](https://github.com/google-gemini/gemini-cli/pull/30013)
76
+ - fix(ci,sdk): run SDK tests in PR CI and fix AgentLoopContext mock in
77
+ session.test.ts by @duvanka-prasad in
78
+ [#30023](https://github.com/google-gemini/gemini-cli/pull/30023)
79
+ - fix(core): prevent $-pattern corruption in LLM prompt templates by
92
80
  @duvanka-prasad in
93
- [#29910](https://github.com/google-gemini/gemini-cli/pull/29910)
94
- - fix(cli): prevent parent command name insertion on /chat list autocomplete by
81
+ [#30035](https://github.com/google-gemini/gemini-cli/pull/30035)
82
+ - fix(cli): Fixes unexpected truncation and toggle behavior in Expandab… by
83
+ @tadipavan in [#29965](https://github.com/google-gemini/gemini-cli/pull/29965)
84
+ - refactor(cli): decouple ToolGroupMessage from internal type guards and payload
85
+ structures by @ugorla-dev in
86
+ [#30041](https://github.com/google-gemini/gemini-cli/pull/30041)
87
+ - fix(core): gate background log stream initialization on execution lifecycle
88
+ transition by @jesussamuel-byte in
89
+ [#30031](https://github.com/google-gemini/gemini-cli/pull/30031)
90
+ - fix(core): honor .git/info/exclude and core.excludesFile in shadow repo by
95
91
  @urielefrenvirtusa in
96
- [#29967](https://github.com/google-gemini/gemini-cli/pull/29967)
97
- - fix(cli): validate finite numbers in numeric settings editor by @diegogodinezr
98
- in [#29968](https://github.com/google-gemini/gemini-cli/pull/29968)
99
- - fix(core): allow trusted system paths on Android (Termux) for ripgrep
100
- resolution (#21836) by @amelidev in
101
- [#29884](https://github.com/google-gemini/gemini-cli/pull/29884)
102
- - fix(core): normalize CRLF line endings before diffing in getDiffContextSnippet
103
- by @jesussamuel-byte in
104
- [#29966](https://github.com/google-gemini/gemini-cli/pull/29966)
105
- - fix(cli): handle terminals that render ambiguous-width characters as wide by
106
- @elberthc-byte in
107
- [#29905](https://github.com/google-gemini/gemini-cli/pull/29905)
108
- - fix(cli): prevent duplicate history and double telemetry in confirm_action
109
- flow by @duvanka-prasad in
110
- [#29974](https://github.com/google-gemini/gemini-cli/pull/29974)
92
+ [#30034](https://github.com/google-gemini/gemini-cli/pull/30034)
93
+ - fix(core): flush pending SSE event buffer at stream EOF in CodeAssistServer by
94
+ @tadipavan in [#30050](https://github.com/google-gemini/gemini-cli/pull/30050)
95
+ - fix(core): handle Windows libuv zero-device stat reporting in
96
+ readSecureFileBuffer by @jvargassanchez-dot in
97
+ [#30044](https://github.com/google-gemini/gemini-cli/pull/30044)
98
+ - fix(cli): serialize concurrent extension installs with per-extension lock
99
+ (#29036) by @diegogodinezr in
100
+ [#30039](https://github.com/google-gemini/gemini-cli/pull/30039)
101
+ - fix(core): resolve symlinked paths canonically in GlobTool by @ugorla-dev in
102
+ [#30042](https://github.com/google-gemini/gemini-cli/pull/30042)
103
+ - fix(cli): add missing active and focus keys to custom theme ui schema by
104
+ @villahernandez-coder in
105
+ [#30032](https://github.com/google-gemini/gemini-cli/pull/30032)
106
+ - fix(core,cli): preserve selected model across transient fallback, cancel, and
107
+ rewind by @villahernandez-coder in
108
+ [#30059](https://github.com/google-gemini/gemini-cli/pull/30059)
109
+ - fix(core): prevent interrupted Whisper model downloads from being treated as
110
+ installed by @tadipavan in
111
+ [#30058](https://github.com/google-gemini/gemini-cli/pull/30058)
112
+ - fix(cli): handle stream failures during extension release downloads by
113
+ @duvanka-prasad in
114
+ [#30100](https://github.com/google-gemini/gemini-cli/pull/30100)
115
+ - fix(core): preserve explicit gemini-2.5-flash model in dynamic model
116
+ resolution by @jesussamuel-byte in
117
+ [#30057](https://github.com/google-gemini/gemini-cli/pull/30057)
118
+ - fix(hooks): support SubagentStop event mapping and merge hook definitions by
119
+ @diegogodinezr in
120
+ [#30111](https://github.com/google-gemini/gemini-cli/pull/30111)
121
+ - fix(cli): await history replay before responding to ACP session/load by
122
+ @tadipavan in [#30112](https://github.com/google-gemini/gemini-cli/pull/30112)
123
+ - fix(sandbox): supply --userns=keep-id for rootless podman by @diegogodinezr in
124
+ [#30118](https://github.com/google-gemini/gemini-cli/pull/30118)
111
125
 
112
126
  **Full Changelog**:
113
- https://github.com/google-gemini/gemini-cli/compare/v0.66.0-preview.0...v0.67.0-preview.0
127
+ https://github.com/google-gemini/gemini-cli/compare/v0.67.0-preview.0...v0.68.0-preview.0
@@ -415,8 +415,14 @@ $env:SANDBOX_FLAGS="--flag1 --flag2=value"
415
415
 
416
416
  ### Linux UID/GID handling
417
417
 
418
- The sandbox automatically handles user permissions on Linux. Override these
419
- permissions with:
418
+ Gemini CLI automatically handles user permissions in container sandboxes on
419
+ Linux. When the sandbox runs as your host UID/GID (the default on supported
420
+ Linux distributions) and you use rootless Podman, Gemini CLI also passes
421
+ `--userns=keep-id`. This keeps files that the sandbox creates in mounted
422
+ directories owned by your host user. To use a different user namespace mode, add
423
+ your own `--userns` option to `SANDBOX_FLAGS`.
424
+
425
+ Override the default Linux UID/GID mapping behavior with:
420
426
 
421
427
  **macOS/Linux**
422
428
 
@@ -127,12 +127,57 @@ for a full list of supported names.
127
127
  You can define multiple custom themes by adding more entries to the
128
128
  `customThemes` object.
129
129
 
130
- ### Loading themes from a file
130
+ ### Standalone `theme.json` file
131
131
 
132
- In addition to defining custom themes in `settings.json`, you can also load a
133
- theme directly from a JSON file by specifying the file path in your
134
- `settings.json`. This is useful for sharing themes or keeping them separate from
135
- your main configuration.
132
+ To keep dynamic color palettes (for example, generated by tools like `wallust`,
133
+ `pywal`, or `matugen`) decoupled from your behavioral settings in
134
+ `settings.json`, Gemini CLI automatically discovers custom themes defined in:
135
+
136
+ 1. `~/.gemini/theme.json` (or `$GEMINI_CLI_HOME/.gemini/theme.json`)
137
+ 2. `$XDG_CONFIG_HOME/gemini/theme.json` (falling back to
138
+ `~/.config/gemini/theme.json`)
139
+
140
+ If the same theme name is defined in multiple places, `~/.gemini/theme.json`
141
+ takes precedence over XDG paths and inline `ui.customThemes` in `settings.json`.
142
+
143
+ `theme.json` can define either a single theme object or a map of named themes:
144
+
145
+ ```json
146
+ {
147
+ "custom-wallust": {
148
+ "name": "custom-wallust",
149
+ "type": "custom",
150
+ "background": {
151
+ "primary": "#181818"
152
+ },
153
+ "text": {
154
+ "primary": "#f0f0f0",
155
+ "secondary": "#a0a0a0"
156
+ }
157
+ }
158
+ }
159
+ ```
160
+
161
+ Then reference the theme by name in `~/.gemini/settings.json` without mixing
162
+ color definitions into your behavioral preferences:
163
+
164
+ ```json
165
+ {
166
+ "ui": {
167
+ "theme": "custom-wallust"
168
+ },
169
+ "general": {
170
+ "vimMode": true
171
+ }
172
+ }
173
+ ```
174
+
175
+ ### Loading themes from an explicit file path
176
+
177
+ In addition to defining custom themes in `settings.json` or
178
+ `~/.gemini/theme.json`, you can also load a theme directly from a JSON file by
179
+ specifying the file path in your `settings.json`. This is useful for sharing
180
+ themes or keeping them separate from your main configuration.
136
181
 
137
182
  To load a theme from a file, set the `theme` property in your `settings.json` to
138
183
  the path of your theme file:
@@ -448,6 +448,10 @@ Slash commands provide meta-level control over the CLI itself.
448
448
  counts and quota information.
449
449
  - **`tools`**:
450
450
  - **Description:** Show tool-specific usage statistics.
451
+ - **`heatmap`**:
452
+ - **Description:** Show a calendar heatmap of daily token usage across local
453
+ chat sessions, with an optional day breakdown.
454
+ - **Usage:** `/stats heatmap [today|yesterday|YYYY-MM-DD]`
451
455
 
452
456
  ### `/terminal-setup`
453
457
 
@@ -547,6 +547,14 @@ their corresponding top-level category object in your `settings.json` file.
547
547
  session. -1 means unlimited.
548
548
  - **Default:** `-1`
549
549
 
550
+ - **`model.requestTimeoutMs`** (number):
551
+
552
+ - **Description:** How long to wait, in milliseconds, for the API to start
553
+ responding before a request is aborted and retried. Defaults to 60000. Raise
554
+ this if long-thinking requests are timing out.
555
+ - **Default:** `undefined`
556
+ - **Requires restart:** Yes
557
+
550
558
  - **`model.summarizeToolOutput`** (object):
551
559
 
552
560
  - **Description:** Enables or disables summarization of tool output. Configure
@@ -1201,15 +1209,7 @@ their corresponding top-level category object in your `settings.json` file.
1201
1209
  ]
1202
1210
  },
1203
1211
  "gemini-2.5-flash": {
1204
- "default": "gemini-2.5-flash",
1205
- "contexts": [
1206
- {
1207
- "condition": {
1208
- "useLatestFlash": true
1209
- },
1210
- "target": "gemini-3.8-flash"
1211
- }
1212
- ]
1212
+ "default": "gemini-2.5-flash"
1213
1213
  },
1214
1214
  "gemini-3-pro-preview": {
1215
1215
  "default": "gemini-3-pro-preview",
@@ -351,6 +351,12 @@ interactive = true
351
351
  # defined in. In chained commands (e.g., cmd1 > file && cmd2), each
352
352
  # individual command rule must permit redirection if it's used.
353
353
  allowRedirection = true
354
+
355
+ # (Optional) If true, lets shell commands use command substitution
356
+ # ($(), backticks, <(), >(), or PowerShell @()). By default, the policy
357
+ # engine asks for confirmation when substitution syntax is detected, even if
358
+ # inner subcommands are also allowed.
359
+ allowCommandSubstitution = true
354
360
  ```
355
361
 
356
362
  ### Using arrays (lists)