@google/gemini-cli-core 0.67.0-preview.0 → 0.68.0-preview.0

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.
Files changed (145) hide show
  1. package/README.md +18 -24
  2. package/dist/docs/changelogs/index.md +24 -0
  3. package/dist/docs/changelogs/latest.md +83 -90
  4. package/dist/docs/changelogs/preview.md +89 -87
  5. package/dist/docs/cli/sandbox.md +8 -2
  6. package/dist/docs/cli/themes.md +6 -3
  7. package/dist/docs/extensions/releasing.md +32 -0
  8. package/dist/docs/reference/configuration.md +2 -10
  9. package/dist/src/availability/autoRoutingFallback.integration.test.js +95 -2
  10. package/dist/src/availability/autoRoutingFallback.integration.test.js.map +1 -1
  11. package/dist/src/availability/errorClassification.d.ts +2 -0
  12. package/dist/src/availability/errorClassification.js +8 -0
  13. package/dist/src/availability/errorClassification.js.map +1 -1
  14. package/dist/src/availability/errorClassification.test.d.ts +6 -0
  15. package/dist/src/availability/errorClassification.test.js +56 -0
  16. package/dist/src/availability/errorClassification.test.js.map +1 -0
  17. package/dist/src/availability/policyHelpers.test.js +8 -1
  18. package/dist/src/availability/policyHelpers.test.js.map +1 -1
  19. package/dist/src/code_assist/oauth2.test.js +4 -1
  20. package/dist/src/code_assist/oauth2.test.js.map +1 -1
  21. package/dist/src/code_assist/server.js +24 -15
  22. package/dist/src/code_assist/server.js.map +1 -1
  23. package/dist/src/code_assist/server.test.js +165 -0
  24. package/dist/src/code_assist/server.test.js.map +1 -1
  25. package/dist/src/config/config.js +1 -0
  26. package/dist/src/config/config.js.map +1 -1
  27. package/dist/src/config/config.test.js +4 -1
  28. package/dist/src/config/config.test.js.map +1 -1
  29. package/dist/src/config/defaultModelConfigs.js +1 -7
  30. package/dist/src/config/defaultModelConfigs.js.map +1 -1
  31. package/dist/src/config/models.d.ts +2 -1
  32. package/dist/src/config/models.js +20 -7
  33. package/dist/src/config/models.js.map +1 -1
  34. package/dist/src/config/models.test.js +43 -1
  35. package/dist/src/config/models.test.js.map +1 -1
  36. package/dist/src/core/baseLlmClient.js +15 -0
  37. package/dist/src/core/baseLlmClient.js.map +1 -1
  38. package/dist/src/core/baseLlmClient.test.js +37 -0
  39. package/dist/src/core/baseLlmClient.test.js.map +1 -1
  40. package/dist/src/core/client.js +26 -1
  41. package/dist/src/core/client.js.map +1 -1
  42. package/dist/src/core/client.test.js +8 -3
  43. package/dist/src/core/client.test.js.map +1 -1
  44. package/dist/src/core/geminiChat.js +29 -4
  45. package/dist/src/core/geminiChat.js.map +1 -1
  46. package/dist/src/core/geminiChat.test.js +80 -0
  47. package/dist/src/core/geminiChat.test.js.map +1 -1
  48. package/dist/src/fallback/handler.js +13 -5
  49. package/dist/src/fallback/handler.js.map +1 -1
  50. package/dist/src/fallback/handler.test.js +30 -2
  51. package/dist/src/fallback/handler.test.js.map +1 -1
  52. package/dist/src/generated/git-commit.d.ts +2 -2
  53. package/dist/src/generated/git-commit.js +2 -2
  54. package/dist/src/ide/process-utils.integration.test.d.ts +6 -0
  55. package/dist/src/ide/process-utils.integration.test.js +276 -0
  56. package/dist/src/ide/process-utils.integration.test.js.map +1 -0
  57. package/dist/src/ide/process-utils.js +69 -20
  58. package/dist/src/ide/process-utils.js.map +1 -1
  59. package/dist/src/ide/process-utils.test.js +161 -18
  60. package/dist/src/ide/process-utils.test.js.map +1 -1
  61. package/dist/src/routing/strategies/defaultStrategy.js +1 -1
  62. package/dist/src/routing/strategies/defaultStrategy.js.map +1 -1
  63. package/dist/src/routing/strategies/defaultStrategy.test.js +14 -0
  64. package/dist/src/routing/strategies/defaultStrategy.test.js.map +1 -1
  65. package/dist/src/routing/strategies/fallbackStrategy.js +3 -2
  66. package/dist/src/routing/strategies/fallbackStrategy.js.map +1 -1
  67. package/dist/src/routing/strategies/fallbackStrategy.test.js +32 -0
  68. package/dist/src/routing/strategies/fallbackStrategy.test.js.map +1 -1
  69. package/dist/src/routing/strategies/overrideStrategy.js +1 -1
  70. package/dist/src/routing/strategies/overrideStrategy.js.map +1 -1
  71. package/dist/src/routing/strategies/overrideStrategy.test.js +11 -0
  72. package/dist/src/routing/strategies/overrideStrategy.test.js.map +1 -1
  73. package/dist/src/services/executionLifecycleService.d.ts +7 -1
  74. package/dist/src/services/executionLifecycleService.js +9 -2
  75. package/dist/src/services/executionLifecycleService.js.map +1 -1
  76. package/dist/src/services/executionLifecycleService.test.js +27 -0
  77. package/dist/src/services/executionLifecycleService.test.js.map +1 -1
  78. package/dist/src/services/gitService.js +136 -2
  79. package/dist/src/services/gitService.js.map +1 -1
  80. package/dist/src/services/gitService.test.js +208 -3
  81. package/dist/src/services/gitService.test.js.map +1 -1
  82. package/dist/src/services/modelConfigService.test.js +23 -0
  83. package/dist/src/services/modelConfigService.test.js.map +1 -1
  84. package/dist/src/services/sessionSummaryService.js +5 -2
  85. package/dist/src/services/sessionSummaryService.js.map +1 -1
  86. package/dist/src/services/sessionSummaryService.test.js +18 -0
  87. package/dist/src/services/sessionSummaryService.test.js.map +1 -1
  88. package/dist/src/services/shellExecutionService.d.ts +2 -1
  89. package/dist/src/services/shellExecutionService.js +15 -5
  90. package/dist/src/services/shellExecutionService.js.map +1 -1
  91. package/dist/src/services/shellExecutionService.test.js +22 -2
  92. package/dist/src/services/shellExecutionService.test.js.map +1 -1
  93. package/dist/src/tools/ask-user.js +2 -1
  94. package/dist/src/tools/ask-user.js.map +1 -1
  95. package/dist/src/tools/ask-user.test.js +28 -0
  96. package/dist/src/tools/ask-user.test.js.map +1 -1
  97. package/dist/src/tools/glob.js +19 -4
  98. package/dist/src/tools/glob.js.map +1 -1
  99. package/dist/src/tools/glob.test.js +91 -0
  100. package/dist/src/tools/glob.test.js.map +1 -1
  101. package/dist/src/tools/shellBackgroundTools.test.js +4 -0
  102. package/dist/src/tools/shellBackgroundTools.test.js.map +1 -1
  103. package/dist/src/tools/write-file.js +1 -1
  104. package/dist/src/tools/write-file.js.map +1 -1
  105. package/dist/src/tools/write-file.test.js +18 -0
  106. package/dist/src/tools/write-file.test.js.map +1 -1
  107. package/dist/src/utils/editCorrector.js +12 -12
  108. package/dist/src/utils/editCorrector.js.map +1 -1
  109. package/dist/src/utils/editCorrector.test.js +16 -0
  110. package/dist/src/utils/editCorrector.test.js.map +1 -1
  111. package/dist/src/utils/events.d.ts +1 -0
  112. package/dist/src/utils/events.js.map +1 -1
  113. package/dist/src/utils/fileUtils.js +39 -19
  114. package/dist/src/utils/fileUtils.js.map +1 -1
  115. package/dist/src/utils/fileUtils.test.js +284 -0
  116. package/dist/src/utils/fileUtils.test.js.map +1 -1
  117. package/dist/src/utils/filesearch/fileSearch.js +36 -5
  118. package/dist/src/utils/filesearch/fileSearch.js.map +1 -1
  119. package/dist/src/utils/filesearch/fileSearch.test.js +146 -0
  120. package/dist/src/utils/filesearch/fileSearch.test.js.map +1 -1
  121. package/dist/src/utils/ignorePathUtils.js +3 -2
  122. package/dist/src/utils/ignorePathUtils.js.map +1 -1
  123. package/dist/src/utils/ignorePathUtils.test.js +20 -1
  124. package/dist/src/utils/ignorePathUtils.test.js.map +1 -1
  125. package/dist/src/utils/llm-edit-fixer.js +13 -10
  126. package/dist/src/utils/llm-edit-fixer.js.map +1 -1
  127. package/dist/src/utils/llm-edit-fixer.test.js +30 -0
  128. package/dist/src/utils/llm-edit-fixer.test.js.map +1 -1
  129. package/dist/src/utils/summarizer.js +7 -3
  130. package/dist/src/utils/summarizer.js.map +1 -1
  131. package/dist/src/utils/summarizer.test.js +14 -0
  132. package/dist/src/utils/summarizer.test.js.map +1 -1
  133. package/dist/src/utils/textUtils.d.ts +7 -0
  134. package/dist/src/utils/textUtils.js +157 -0
  135. package/dist/src/utils/textUtils.js.map +1 -1
  136. package/dist/src/utils/textUtils.test.js +41 -1
  137. package/dist/src/utils/textUtils.test.js.map +1 -1
  138. package/dist/src/voice/whisperModelManager.d.ts +4 -1
  139. package/dist/src/voice/whisperModelManager.js +175 -8
  140. package/dist/src/voice/whisperModelManager.js.map +1 -1
  141. package/dist/src/voice/whisperModelManager.test.d.ts +6 -0
  142. package/dist/src/voice/whisperModelManager.test.js +514 -0
  143. package/dist/src/voice/whisperModelManager.test.js.map +1 -0
  144. package/dist/tsconfig.tsbuildinfo +1 -1
  145. package/package.json +1 -1
package/README.md CHANGED
@@ -1,12 +1,3 @@
1
- > [!NOTE]
2
- >
3
- > **Unpaid tier and Google One users:** Gemini CLI was replaced by Antigravity
4
- > CLI on June 18th, 2026. To learn more, see our
5
- > [blog post](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli).
6
- >
7
- > **Gemini CLI has not been optimized for Gemini 4 Argon.** To use Gemini 4
8
- > Argon, please use Antigravity.
9
-
10
1
  # Gemini CLI
11
2
 
12
3
  [![Gemini CLI CI](https://github.com/google-gemini/gemini-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/google-gemini/gemini-cli/actions/workflows/ci.yml)
@@ -15,17 +6,26 @@
15
6
  [![License](https://img.shields.io/github/license/google-gemini/gemini-cli)](https://github.com/google-gemini/gemini-cli/blob/main/LICENSE)
16
7
  [![View Code Wiki](https://assets.codewiki.google/readme-badge/static.svg)](https://codewiki.google/github.com/google-gemini/gemini-cli?utm_source=badge&utm_medium=github&utm_campaign=github.com/google-gemini/gemini-cli)
17
8
 
18
- > [!NOTE]
9
+ <!-- prettier-ignore -->
10
+ > [!IMPORTANT]
11
+ > **Read before installing — Gemini CLI status & tool guide**
19
12
  >
20
- > Gemini CLI is not optimized for the latest Gemini models. For the best coding
21
- > experience with Gemini models use
22
- > [Antigravity CLI](https://antigravity.google/product/antigravity-cli)
23
-
24
- Gemini CLI is an open-source AI agent that brings the power of Gemini directly
25
- into your terminal. It provides lightweight access to Gemini, giving you the
26
- most direct path from your prompt to our model.
13
+ > - **Enterprise Code Assist only:** Designed for **Gemini Code Assist Standard / Enterprise** licenses and **Code Assist for GitHub** on Google Cloud (your access remains unchanged).
14
+ > - **No free tier or Google AI plans:** Free individual access and **Google AI Pro / Ultra** (Google One) moved to [Antigravity CLI](https://antigravity.google/product/antigravity-cli) on June 18, 2026 ([transition post](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)).
15
+ > - **Not optimized for Gemini 4+:** Not tuned for the **Gemini 4** series (for example, [Gemini 4 Argon](https://blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-4-argon/)) or future releases in this or later generations.
16
+ > - **Not for model benchmarks:** Don't use Gemini CLI to benchmark Gemini models—its harness isn't tuned for Gemini 4+ and produces unrepresentative scores.
17
+ >
18
+ > **Which Google CLI do you need?**
19
+ >
20
+ > | Tool | Best for | Links |
21
+ > | :--- | :--- | :--- |
22
+ > | **[Antigravity CLI](https://antigravity.google/product/antigravity-cli)** (`agy`) | Interactive multi-agent coding terminal. Use for **Gemini 4 Argon**+, free / **Google AI Pro & Ultra** accounts, or Google Cloud. | [Download](https://antigravity.google/download) · [Migrate](https://antigravity.google/docs/cli/gcli-migration) · [Argon post](https://antigravity.google/blog/gemini-4-argon-in-google-antigravity) |
23
+ > | **[Gemini API CLI](https://github.com/google-gemini/gemini-api-cli)** (`gemini-api`) | Stateless API CLI *(not a coding harness)*. Gives agents (`agy`, Claude Code, Codex), scripts, and CI direct commands for Gemini models, media gen, file analysis, and managed agents. | [GitHub](https://github.com/google-gemini/gemini-api-cli) · [Releases](https://github.com/google-gemini/gemini-api-cli/releases) · [API docs](https://ai.google.dev/gemini-api/docs) |
24
+ > | **Gemini CLI** (`gemini`, *this repo*) | Organizations with **Gemini Code Assist Standard / Enterprise** or **Code Assist for GitHub** on Google Cloud *(plus legacy paid API / Vertex keys)*. | [Docs](https://geminicli.com/docs/) |
27
25
 
28
- Learn all about Gemini CLI in our [documentation](https://geminicli.com/docs/).
26
+ Gemini CLI (`gemini`) is an open-source terminal agent maintained for enterprise
27
+ Gemini Code Assist workflows on Google Cloud. Learn more in the
28
+ [Gemini CLI documentation](https://geminicli.com/docs/).
29
29
 
30
30
  ## 📦 Installation
31
31
 
@@ -172,12 +172,6 @@ For Google Workspace accounts and other authentication methods, see the
172
172
 
173
173
  ## 🚀 Getting Started
174
174
 
175
- > [!NOTE]
176
- >
177
- > Gemini CLI is not optimized for the latest Gemini models. For the best coding
178
- > experience with Gemini models use
179
- > [Antigravity CLI](https://antigravity.google/product/antigravity-cli)
180
-
181
175
  ### Basic Usage
182
176
 
183
177
  #### Start in current directory
@@ -18,6 +18,30 @@ 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.66.0 - 2026-10-27
22
+
23
+ - **Terminal UI Rendering & Flicker Prevention:** Implemented synchronized
24
+ output mode and isolated spinner rendering, eliminated buffer flickering, and
25
+ preserved terminal scrollback during viewport refreshes
26
+ ([#29725](https://github.com/google-gemini/gemini-cli/pull/29725) by
27
+ @diegogodinezr,
28
+ [#29695](https://github.com/google-gemini/gemini-cli/pull/29695) by
29
+ @ugorla-dev).
30
+ - **Tool Scheduling & Process Lifecycle:** Emitted tool call groups directly
31
+ from the scheduler and forwarded process termination signals from bootstrap
32
+ parent to child processes
33
+ ([#29736](https://github.com/google-gemini/gemini-cli/pull/29736) by
34
+ @jesussamuel-byte,
35
+ [#29790](https://github.com/google-gemini/gemini-cli/pull/29790) by
36
+ @villahernandez-coder).
37
+ - **Environment & MCP OAuth Security:** Supported opt-in private network
38
+ endpoints for MCP OAuth flows and preserved user-level git configuration while
39
+ suppressing interactive prompts
40
+ ([#29844](https://github.com/google-gemini/gemini-cli/pull/29844) by
41
+ @luisfelipe-alt,
42
+ [#29832](https://github.com/google-gemini/gemini-cli/pull/29832) by
43
+ @jesussamuel-byte).
44
+
21
45
  ## Announcements: v0.65.0 - 2026-10-20
22
46
 
23
47
  - **Custom Telemetry Headers:** Added support for configuring custom OTLP
@@ -1,6 +1,6 @@
1
- # Latest stable release: v0.65.0
1
+ # Latest stable release: v0.66.0
2
2
 
3
- Released: October 20, 2026
3
+ Released: October 27, 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,103 +11,96 @@ npm install -g @google/gemini-cli
11
11
 
12
12
  ## Highlights
13
13
 
14
- - **Custom Telemetry Headers:** Added support for configuring custom OTLP
15
- headers in telemetry settings, enabling authentication and header
16
- customization for OpenTelemetry collectors.
17
- - **File System Performance & Traversal:** Optimized ignore pattern filtering
18
- with subtree pruning to accelerate directory scanning, deferred recursive file
19
- reads for `@<directory>` references, and improved empty file handling across
20
- multi-byte encodings.
21
- - **Session Resilience & State Integrity:** Prevented session poisoning during
22
- rapid Ctrl+C interruptions, preserved resumed session history on quick exits,
23
- and eliminated duplicate tool response turns upon resuming sessions.
24
- - **Authentication & Workspace Security:** Enforced read-only workspace settings
25
- in untrusted folders, aligned OAuth callback parameter validation with RFC
26
- 9207 metadata, and resolved infinite authentication retry loops.
27
- - **Terminal UI & Interactive Stability:** Resolved interactive mode hangs on
28
- Enter keypresses, prevented unnecessary terminal clears and scroll resets when
29
- expanding output with Ctrl+O, and restored debounced static UI refreshes on
30
- terminal width changes.
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.
31
30
 
32
31
  ## What's Changed
33
32
 
34
- - fix(cli): enforce read-only workspace settings in untrusted folders by
35
- @jvargassanchez-dot in
36
- [#29583](https://github.com/google-gemini/gemini-cli/pull/29583)
37
- - fix(core): avoid duplicate tool response turns when resuming sessions by
38
- @diegogodinezr in
39
- [#29618](https://github.com/google-gemini/gemini-cli/pull/29618)
40
- - fix(core): prevent deletion of resumed session history on quick exit (#29198)
41
- by @villahernandez-coder in
42
- [#29584](https://github.com/google-gemini/gemini-cli/pull/29584)
43
- - Changelog for v0.64.0-preview.0 by @gemini-cli-robot in
44
- [#29656](https://github.com/google-gemini/gemini-cli/pull/29656)
45
- - Changelog for v0.63.0 by @gemini-cli-robot in
46
- [#29659](https://github.com/google-gemini/gemini-cli/pull/29659)
47
- - fix(core): align OAuth callback iss parameter validation with RFC 9207
48
- metadata by @luisfelipe-alt in
49
- [#29616](https://github.com/google-gemini/gemini-cli/pull/29616)
50
- - fix(cli): prevent unnecessary terminal clears and scroll resets when expanding
51
- with Ctrl+O by @jesussamuel-byte in
52
- [#29640](https://github.com/google-gemini/gemini-cli/pull/29640)
53
- - chore(release): bump version to 0.65.0-nightly.20261006.gfb972b2f8 by
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
54
39
  @gemini-cli-robot in
55
- [#29657](https://github.com/google-gemini/gemini-cli/pull/29657)
56
- - fix(ci): add missing loop in unassign-inactive-assignees workflow by
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
57
47
  @ugorla-dev in
58
- [#29609](https://github.com/google-gemini/gemini-cli/pull/29609)
59
- - fix(core): enforce terminal user turn invariant and normalize request contents
60
- by @luisfelipe-alt in
61
- [#29612](https://github.com/google-gemini/gemini-cli/pull/29612)
62
- - `feat(telemetry): support custom OTLP headers in telemetry configuration` by
63
- @jesussamuel-byte in
64
- [#29641](https://github.com/google-gemini/gemini-cli/pull/29641)
65
- - fix(auth): prevent infinite verification and OAuth retry loops by
48
+ [#29695](https://github.com/google-gemini/gemini-cli/pull/29695)
49
+ - fix(cli): prevent right-hand border bleed in scrollable tool containers by
66
50
  @villahernandez-coder in
67
- [#29655](https://github.com/google-gemini/gemini-cli/pull/29655)
68
- - fix(cli): handle JSON parse and response stream errors in fetchJson by
69
- @jesussamuel-byte in
70
- [#29658](https://github.com/google-gemini/gemini-cli/pull/29658)
71
- - fix(core): preserve line terminators in truncateString by @diegogodinezr in
72
- [#29673](https://github.com/google-gemini/gemini-cli/pull/29673)
73
- - fix(vscode-ide-companion): make IdeServer.stop() resolve while MCP sessions
74
- are open by @elberthc-byte in
75
- [#29674](https://github.com/google-gemini/gemini-cli/pull/29674)
76
- - fix(core): retain ask_user question text in the tool result display by
77
- @elberthc-byte in
78
- [#29677](https://github.com/google-gemini/gemini-cli/pull/29677)
79
- - fix(core): eliminate false positives on untrusted command flags and compound
80
- loops by @DavidAPierce in
81
- [#29672](https://github.com/google-gemini/gemini-cli/pull/29672)
82
- - fix(cli): clear cached credentials when re-selecting Google login by
83
- @urielefrenvirtusa in
84
- [#29643](https://github.com/google-gemini/gemini-cli/pull/29643)
85
- - fix(cli): resolve hang on Enter keypress in interactive mode (#23297) by
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
61
+ @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
86
64
  @elberthc-byte in
87
- [#29476](https://github.com/google-gemini/gemini-cli/pull/29476)
88
- - perf(core): optimize ignore filtering and enable subtree pruning (#29077) by
89
- @amelidev in [#29582](https://github.com/google-gemini/gemini-cli/pull/29582)
90
- - fix(a2a-server): isolate tool rejection to active call in sequential batches
91
- by @jvargassanchez-dot in
92
- [#29683](https://github.com/google-gemini/gemini-cli/pull/29683)
93
- - fix(cli): skip eager recursive file reading for @<directory> references by
65
+ [#29750](https://github.com/google-gemini/gemini-cli/pull/29750)
66
+ - fix(core): harden SKILL.md frontmatter parsing for single-line descriptions by
67
+ @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
94
77
  @jvargassanchez-dot in
95
- [#29617](https://github.com/google-gemini/gemini-cli/pull/29617)
96
- - fix(cli): keep loading other extensions when one fails the allowlist check by
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
88
+ @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
97
91
  @jesussamuel-byte in
98
- [#29720](https://github.com/google-gemini/gemini-cli/pull/29720)
99
- - fix(cli): correct reverse search highlight index for expanding unicode
100
- characters by @diegogodinezr in
101
- [#29699](https://github.com/google-gemini/gemini-cli/pull/29699)
102
- - fix(core): treat whitespace-only UTF-16 and UTF-32 files as empty by
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
103
96
  @jesussamuel-byte in
104
- [#29722](https://github.com/google-gemini/gemini-cli/pull/29722)
105
- - fix(cli): restore debounced static UI refresh on terminal width changes by
106
- @jvargassanchez-dot in
107
- [#29644](https://github.com/google-gemini/gemini-cli/pull/29644)
108
- - fix(cli): prevent session poisoning on rapid Ctrl-C interruption by
109
- @villahernandez-coder in
110
- [#29728](https://github.com/google-gemini/gemini-cli/pull/29728)
97
+ [#29832](https://github.com/google-gemini/gemini-cli/pull/29832)
98
+ - fix(core): prevent false positive matches in isAuthenticationError by
99
+ @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)
111
104
 
112
105
  **Full Changelog**:
113
- https://github.com/google-gemini/gemini-cli/compare/v0.64.0...v0.65.0
106
+ https://github.com/google-gemini/gemini-cli/compare/v0.65.0...v0.66.0
@@ -1,6 +1,6 @@
1
- # Preview release: v0.66.0-preview.0
1
+ # Preview release: v0.67.0-preview.0
2
2
 
3
- Released: October 20, 2026
3
+ Released: October 27, 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,99 +13,101 @@ npm install -g @google/gemini-cli@preview
13
13
 
14
14
  ## Highlights
15
15
 
16
- - **Terminal UI & Output Synchronization**: Implemented synchronized terminal
17
- output and isolated spinner rendering to prevent flickering, preserved
18
- terminal scrollback during viewport refreshes, corrected debug console height
19
- calculations, and eliminated right-hand border bleed in scrollable tool
20
- containers.
21
- - **Tool Execution & Scheduler Architecture**: Refactored the tool execution
22
- flow to emit tool call groups directly from the scheduler, removing UI
23
- lookahead logic and simplifying execution scheduling.
24
- - **Shell & Git Environment Integrity**: Preserved user-level `~/.gitconfig`
25
- settings across shell and Git environments, disabled interactive credential
26
- and SSH prompts to prevent hangs in automated environments, and forwarded
27
- termination signals from bootstrap parent processes.
28
- - **Configuration & Keybindings Flexibility**: Added support for a `keys` array
29
- in `keybindings.json`, ensured settings placeholders resolve correctly after
30
- loading `.env` files, and improved CLI self-update verification against PATH
31
- shadowing.
32
- - **Networking & MCP Security**: Supported opt-in private network endpoints for
33
- MCP OAuth flows and prevented false positive matches in authentication error
34
- handling.
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.
35
31
 
36
32
  ## What's Changed
37
33
 
38
- - Update ROADMAP.md to no longer reference outdated 2025 roadmap by
39
- @DavidAPierce in
40
- [#29723](https://github.com/google-gemini/gemini-cli/pull/29723)
41
- - Changelog for v0.65.0-preview.0 by @gemini-cli-robot in
42
- [#29739](https://github.com/google-gemini/gemini-cli/pull/29739)
43
- - chore(release): bump version to 0.66.0-nightly.20261013.g204db94ae by
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
44
37
  @gemini-cli-robot in
45
- [#29740](https://github.com/google-gemini/gemini-cli/pull/29740)
46
- - Changelog for v0.64.0 by @gemini-cli-robot in
47
- [#29741](https://github.com/google-gemini/gemini-cli/pull/29741)
48
- - fix(ui): implement synchronized output and isolate spinner rendering by
49
- @diegogodinezr in
50
- [#29725](https://github.com/google-gemini/gemini-cli/pull/29725)
51
- - fix(ui): fix debug console height calculation and terminalBuffer flickering by
52
- @ugorla-dev in
53
- [#29695](https://github.com/google-gemini/gemini-cli/pull/29695)
54
- - fix(cli): prevent right-hand border bleed in scrollable tool containers by
55
- @villahernandez-coder in
56
- [#29742](https://github.com/google-gemini/gemini-cli/pull/29742)
57
- - refactor(core,cli): emit tool call groups from the scheduler and drop the UI
58
- lookahead by @jesussamuel-byte in
59
- [#29736](https://github.com/google-gemini/gemini-cli/pull/29736)
60
- - fix(core): format and quote Windows diff command arguments in openDiff by
61
- @jvargassanchez-dot in
62
- [#29753](https://github.com/google-gemini/gemini-cli/pull/29753)
63
- - fix(cli): round before selecting units in formatDuration by @diegogodinezr in
64
- [#29766](https://github.com/google-gemini/gemini-cli/pull/29766)
65
- - fix(core): disable interactive credential and SSH prompts in getSafeGitEnv by
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
66
48
  @villahernandez-coder in
67
- [#29760](https://github.com/google-gemini/gemini-cli/pull/29760)
68
- - fix(cli): resolve settings placeholders after loading .env files by
69
- @elberthc-byte in
70
- [#29750](https://github.com/google-gemini/gemini-cli/pull/29750)
71
- - fix(core): harden SKILL.md frontmatter parsing for single-line descriptions by
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
72
54
  @jesussamuel-byte in
73
- [#29769](https://github.com/google-gemini/gemini-cli/pull/29769)
74
- - Add Banner about Gemini CLI not being optimized for Gemini 4 by @srithreepo in
75
- [#29774](https://github.com/google-gemini/gemini-cli/pull/29774)
76
- - Update README to remove obsolete content by @srithreepo in
77
- [#29775](https://github.com/google-gemini/gemini-cli/pull/29775)
78
- - fix(ci): remove unsupported members permission in unassign-inactive-assignees
79
- workflow by @ugorla-dev in
80
- [#29770](https://github.com/google-gemini/gemini-cli/pull/29770)
81
- - fix(cli): reset slash-command conflict dedupe when conflicts reappear by
82
- @jvargassanchez-dot in
83
- [#29768](https://github.com/google-gemini/gemini-cli/pull/29768)
84
- - fix(cli): verify active binary update to prevent PATH shadowing false success
85
- by @urielefrenvirtusa in
86
- [#29757](https://github.com/google-gemini/gemini-cli/pull/29757)
87
- - fix(cli): support 'keys' array in keybindings.json by @urielefrenvirtusa in
88
- [#29773](https://github.com/google-gemini/gemini-cli/pull/29773)
89
- - fix(cli): forward termination signals from bootstrap parent to child process
90
- by @villahernandez-coder in
91
- [#29790](https://github.com/google-gemini/gemini-cli/pull/29790)
92
- - fix(ui): preserve terminal scrollback during viewport refreshes by
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
93
57
  @diegogodinezr in
94
- [#29792](https://github.com/google-gemini/gemini-cli/pull/29792)
95
- - fix(cli): decode streamed Node HTTP activity chunks with StringDecoder by
96
- @jesussamuel-byte in
97
- [#29827](https://github.com/google-gemini/gemini-cli/pull/29827)
98
- - chore: migrate gsutil usage to gcloud storage by @gurusai-voleti in
99
- [#29839](https://github.com/google-gemini/gemini-cli/pull/29839)
100
- - fix(core): preserve user-level ~/.gitconfig in shell and git environments by
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
101
89
  @jesussamuel-byte in
102
- [#29832](https://github.com/google-gemini/gemini-cli/pull/29832)
103
- - fix(core): prevent false positive matches in isAuthenticationError by
90
+ [#29961](https://github.com/google-gemini/gemini-cli/pull/29961)
91
+ - fix(acp): include MCP server and tool metadata in permission requests by
92
+ @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
104
95
  @urielefrenvirtusa in
105
- [#29835](https://github.com/google-gemini/gemini-cli/pull/29835)
106
- - fix(core): support opt-in private network endpoints for MCP OAuth flows by
107
- @luisfelipe-alt in
108
- [#29844](https://github.com/google-gemini/gemini-cli/pull/29844)
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)
109
111
 
110
112
  **Full Changelog**:
111
- https://github.com/google-gemini/gemini-cli/compare/v0.65.0-preview.0...v0.66.0-preview.0
113
+ https://github.com/google-gemini/gemini-cli/compare/v0.66.0-preview.0...v0.67.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
 
@@ -97,7 +97,6 @@ nested configuration objects. For example:
97
97
  - `diff.removed`: Background for removed lines in diffs.
98
98
  - **`border`**: Defines border colors.
99
99
  - `default`: The standard border color.
100
- - `focused`: Border color when an element is focused.
101
100
  - **`status`**: Colors for status indicators.
102
101
  - `success`: Used for successful operations.
103
102
  - `warning`: Used for warnings.
@@ -105,6 +104,9 @@ nested configuration objects. For example:
105
104
  - **`ui`**: Other UI elements.
106
105
  - `comment`: Color for code comments.
107
106
  - `symbol`: Color for code symbols and operators.
107
+ - `active`: Border and text color for active or running elements.
108
+ - `focus`: Color for focused elements, such as selected menu items and focused
109
+ borders.
108
110
  - `gradient`: An array of colors used for gradient effects.
109
111
 
110
112
  **Required properties:**
@@ -166,8 +168,7 @@ custom theme defined in `settings.json`.
166
168
  "accent": "#d3869b"
167
169
  },
168
170
  "border": {
169
- "default": "#3c3836",
170
- "focused": "#458588"
171
+ "default": "#3c3836"
171
172
  },
172
173
  "status": {
173
174
  "success": "#b8bb26",
@@ -177,6 +178,8 @@ custom theme defined in `settings.json`.
177
178
  "ui": {
178
179
  "comment": "#928374",
179
180
  "symbol": "#8ec07c",
181
+ "active": "#83a598",
182
+ "focus": "#b8bb26",
180
183
  "gradient": ["#cc241d", "#d65d0e", "#d79921"]
181
184
  }
182
185
  }
@@ -29,6 +29,38 @@ To have your extension automatically discovered and listed:
29
29
  Our system crawls tagged repositories daily. Once you tag your repository, your
30
30
  extension will appear in the gallery if it passes validation.
31
31
 
32
+ ### Troubleshooting gallery indexing
33
+
34
+ If your extension doesn't appear in the gallery after 24 to 48 hours despite
35
+ meeting the listing requirements, GitHub Code Search may not have indexed your
36
+ repository's manifest file yet.
37
+
38
+ The gallery crawler relies on GitHub Code Search to discover
39
+ `gemini-extension.json` files across public repositories. Newly created or
40
+ recently pushed repositories are often indexed lazily by GitHub.
41
+
42
+ To check whether GitHub has indexed your repository's manifest, run the
43
+ following command using the GitHub CLI:
44
+
45
+ ```bash
46
+ gh api 'search/code?q=repo:<owner>/<repo>+filename:gemini-extension.json' --jq .total_count
47
+ ```
48
+
49
+ If the count is `0`, or if you don't use the GitHub CLI, trigger indexing
50
+ manually in your web browser:
51
+
52
+ 1. Sign in to GitHub.
53
+ 2. Navigate to
54
+ `https://github.com/search?q=repo%3A<owner>%2F<repo>+gemini-extension.json&type=code`
55
+ (replace `<owner>/<repo>` with your repository path).
56
+ 3. If GitHub displays "This repository's code is being indexed right now", wait
57
+ 15 to 30 minutes for indexing to finish.
58
+ 4. Re-run the search until `gemini-extension.json` appears in the search
59
+ results.
60
+
61
+ Once GitHub indexes the manifest file, the crawler will discover and index your
62
+ extension during its next scheduled cycle.
63
+
32
64
  ## Release through a Git repository
33
65
 
34
66
  Releasing through Git is the most flexible option. Create a public Git
@@ -1056,7 +1056,7 @@ their corresponding top-level category object in your `settings.json` file.
1056
1056
  "auto": {
1057
1057
  "displayName": "Auto",
1058
1058
  "tier": "auto",
1059
- "isPreview": true,
1059
+ "isPreview": false,
1060
1060
  "isVisible": true,
1061
1061
  "features": {
1062
1062
  "thinking": true,
@@ -1191,15 +1191,7 @@ their corresponding top-level category object in your `settings.json` file.
1191
1191
  ]
1192
1192
  },
1193
1193
  "gemini-2.5-flash": {
1194
- "default": "gemini-2.5-flash",
1195
- "contexts": [
1196
- {
1197
- "condition": {
1198
- "useLatestFlash": true
1199
- },
1200
- "target": "gemini-3.8-flash"
1201
- }
1202
- ]
1194
+ "default": "gemini-2.5-flash"
1203
1195
  },
1204
1196
  "gemini-3-pro-preview": {
1205
1197
  "default": "gemini-3-pro-preview",