@google/gemini-cli 0.34.0-nightly.20260310.4653b126f → 0.34.0-preview.1

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 (48) hide show
  1. package/README.md +3 -3
  2. package/bundle/docs/CONTRIBUTING.md +4 -0
  3. package/bundle/docs/assets/theme-ansi-dark.png +0 -0
  4. package/bundle/docs/assets/theme-ansi-light.png +0 -0
  5. package/bundle/docs/assets/theme-atom-one-dark.png +0 -0
  6. package/bundle/docs/assets/theme-ayu-dark.png +0 -0
  7. package/bundle/docs/assets/theme-ayu-light.png +0 -0
  8. package/bundle/docs/assets/theme-default-dark.png +0 -0
  9. package/bundle/docs/assets/theme-default-light.png +0 -0
  10. package/bundle/docs/assets/theme-dracula-dark.png +0 -0
  11. package/bundle/docs/assets/theme-github-dark.png +0 -0
  12. package/bundle/docs/assets/theme-github-light.png +0 -0
  13. package/bundle/docs/assets/theme-google-light.png +0 -0
  14. package/bundle/docs/assets/theme-holiday-dark.png +0 -0
  15. package/bundle/docs/assets/theme-shades-of-purple-dark.png +0 -0
  16. package/bundle/docs/assets/theme-solarized-dark.png +0 -0
  17. package/bundle/docs/assets/theme-solarized-light.png +0 -0
  18. package/bundle/docs/assets/theme-xcode-light.png +0 -0
  19. package/bundle/docs/changelogs/preview.md +10 -3
  20. package/bundle/docs/cli/headless.md +2 -1
  21. package/bundle/docs/cli/plan-mode.md +21 -0
  22. package/bundle/docs/cli/settings.md +2 -1
  23. package/bundle/docs/cli/telemetry.md +1017 -750
  24. package/bundle/docs/cli/themes.md +26 -16
  25. package/bundle/docs/cli/tutorials/mcp-setup.md +1 -1
  26. package/bundle/docs/core/subagents.md +1 -1
  27. package/bundle/docs/extensions/reference.md +4 -2
  28. package/bundle/docs/get-started/authentication.md +7 -7
  29. package/bundle/docs/get-started/index.md +1 -1
  30. package/bundle/docs/hooks/reference.md +1 -1
  31. package/bundle/docs/local-development.md +71 -27
  32. package/bundle/docs/reference/configuration.md +26 -8
  33. package/bundle/docs/reference/keyboard-shortcuts.md +14 -9
  34. package/bundle/docs/reference/policy-engine.md +20 -7
  35. package/bundle/docs/release-confidence.md +2 -2
  36. package/bundle/docs/resources/tos-privacy.md +3 -3
  37. package/bundle/docs/resources/troubleshooting.md +2 -2
  38. package/bundle/docs/sidebar.json +1 -1
  39. package/bundle/docs/tools/mcp-server.md +28 -15
  40. package/bundle/gemini.js +193207 -185986
  41. package/bundle/node_modules/@google/gemini-cli-devtools/package.json +1 -1
  42. package/package.json +1 -1
  43. package/bundle/docs/assets/theme-ansi.png +0 -0
  44. package/bundle/docs/assets/theme-atom-one.png +0 -0
  45. package/bundle/docs/assets/theme-ayu.png +0 -0
  46. package/bundle/docs/assets/theme-default.png +0 -0
  47. package/bundle/docs/assets/theme-dracula.png +0 -0
  48. package/bundle/docs/assets/theme-github.png +0 -0
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
  [![License](https://img.shields.io/github/license/google-gemini/gemini-cli)](https://github.com/google-gemini/gemini-cli/blob/main/LICENSE)
7
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)
8
8
 
9
- ![Gemini CLI Screenshot](./docs/assets/gemini-screenshot.png)
9
+ ![Gemini CLI Screenshot](/docs/assets/gemini-screenshot.png)
10
10
 
11
11
  Gemini CLI is an open-source AI agent that brings the power of Gemini directly
12
12
  into your terminal. It provides lightweight access to Gemini, giving you the
@@ -147,7 +147,7 @@ Integrate Gemini CLI directly into your GitHub workflows with
147
147
 
148
148
  Choose the authentication method that best fits your needs:
149
149
 
150
- ### Option 1: Login with Google (OAuth login using your Google Account)
150
+ ### Option 1: Sign in with Google (OAuth login using your Google Account)
151
151
 
152
152
  **✨ Best for:** Individual developers as well as anyone who has a Gemini Code
153
153
  Assist License. (see
@@ -161,7 +161,7 @@ for details)
161
161
  - **No API key management** - just sign in with your Google account
162
162
  - **Automatic updates** to latest models
163
163
 
164
- #### Start Gemini CLI, then choose _Login with Google_ and follow the browser authentication flow when prompted
164
+ #### Start Gemini CLI, then choose _Sign in with Google_ and follow the browser authentication flow when prompted
165
165
 
166
166
  ```bash
167
167
  gemini
@@ -77,6 +77,10 @@ You can run the review tool in two ways:
77
77
  ./scripts/review.sh <PR_NUMBER> [model]
78
78
  ```
79
79
 
80
+ **Warning:** If you run `scripts/review.sh`, you must have first verified
81
+ that the code for the PR being reviewed is safe to run and does not contain
82
+ data exfiltration attacks.
83
+
80
84
  **Authors are strongly encouraged to run this script on their own PRs**
81
85
  immediately after creation. This allows you to catch and fix simple issues
82
86
  locally before a maintainer performs a full review.
@@ -1,6 +1,6 @@
1
- # Preview release: v0.33.0-preview.4
1
+ # Preview release: v0.33.0-preview.14
2
2
 
3
- Released: March 06, 2026
3
+ Released: March 10, 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).
@@ -29,6 +29,13 @@ npm install -g @google/gemini-cli@preview
29
29
 
30
30
  ## What's Changed
31
31
 
32
+ - fix(patch): cherry-pick 1b69637 to release/v0.33.0-preview.13-pr-21467
33
+ [CONFLICTS] by @gemini-cli-robot in
34
+ [#21930](https://github.com/google-gemini/gemini-cli/pull/21930)
35
+ - fix(patch): cherry-pick e5615f4 to release/v0.33.0-preview.12-pr-21037 to
36
+ patch version v0.33.0-preview.12 and create version 0.33.0-preview.13 by
37
+ @gemini-cli-robot in
38
+ [#21922](https://github.com/google-gemini/gemini-cli/pull/21922)
32
39
  - fix(patch): cherry-pick 7ec477d to release/v0.33.0-preview.3-pr-21305 to patch
33
40
  version v0.33.0-preview.3 and create version 0.33.0-preview.4 by
34
41
  @gemini-cli-robot in
@@ -198,4 +205,4 @@ npm install -g @google/gemini-cli@preview
198
205
  [#20991](https://github.com/google-gemini/gemini-cli/pull/20991)
199
206
 
200
207
  **Full Changelog**:
201
- https://github.com/google-gemini/gemini-cli/compare/v0.32.0-preview.0...v0.33.0-preview.4
208
+ https://github.com/google-gemini/gemini-cli/compare/v0.32.0-preview.0...v0.33.0-preview.14
@@ -31,7 +31,8 @@ Returns a stream of newline-delimited JSON (JSONL) events.
31
31
  - `tool_use`: Tool call requests with arguments.
32
32
  - `tool_result`: Output from executed tools.
33
33
  - `error`: Non-fatal warnings and system errors.
34
- - `result`: Final outcome with aggregated statistics.
34
+ - `result`: Final outcome with aggregated statistics and per-model token usage
35
+ breakdowns.
35
36
 
36
37
  ## Exit codes
37
38
 
@@ -150,6 +150,27 @@ Plan Mode's default tool restrictions are managed by the
150
150
  but you can customize these rules by creating your own policies in your
151
151
  `~/.gemini/policies/` directory (Tier 2).
152
152
 
153
+ #### Global vs. mode-specific rules
154
+
155
+ As described in the
156
+ [policy engine documentation](../reference/policy-engine.md#approval-modes), any
157
+ rule that does not explicitly specify `modes` is considered "always active" and
158
+ will apply to Plan Mode as well.
159
+
160
+ If you want a rule to apply to other modes but _not_ to Plan Mode, you must
161
+ explicitly specify the target modes. For example, to allow `npm test` in default
162
+ and Auto-Edit modes but not in Plan Mode:
163
+
164
+ ```toml
165
+ [[rule]]
166
+ toolName = "run_shell_command"
167
+ commandPrefix = "npm test"
168
+ decision = "allow"
169
+ priority = 100
170
+ # By omitting "plan", this rule will not be active in Plan Mode.
171
+ modes = ["default", "autoEdit"]
172
+ ```
173
+
153
174
  #### Example: Automatically approve read-only MCP tools
154
175
 
155
176
  By default, read-only MCP tools require user confirmation in Plan Mode. You can
@@ -66,7 +66,7 @@ they appear in the UI.
66
66
  | Show Line Numbers | `ui.showLineNumbers` | Show line numbers in the chat. | `true` |
67
67
  | Show Citations | `ui.showCitations` | Show citations for generated text in the chat. | `false` |
68
68
  | Show Model Info In Chat | `ui.showModelInfoInChat` | Show the model name in the chat for each model turn. | `false` |
69
- | Show User Identity | `ui.showUserIdentity` | Show the logged-in user's identity (e.g. email) in the UI. | `true` |
69
+ | Show User Identity | `ui.showUserIdentity` | Show the signed-in user's identity (e.g. email) in the UI. | `true` |
70
70
  | Use Alternate Screen Buffer | `ui.useAlternateBuffer` | Use an alternate screen buffer for the UI, preserving shell history. | `false` |
71
71
  | Use Background Color | `ui.useBackgroundColor` | Whether to use background colors in the UI. | `true` |
72
72
  | Incremental Rendering | `ui.incrementalRendering` | Enable incremental rendering for the UI. This option will reduce flickering but may cause rendering artifacts. Only supported when useAlternateBuffer is enabled. | `true` |
@@ -125,6 +125,7 @@ they appear in the UI.
125
125
  | ------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- |
126
126
  | Disable YOLO Mode | `security.disableYoloMode` | Disable YOLO mode, even if enabled by a flag. | `false` |
127
127
  | Allow Permanent Tool Approval | `security.enablePermanentToolApproval` | Enable the "Allow for all future sessions" option in tool confirmation dialogs. | `false` |
128
+ | Auto-add to Policy by Default | `security.autoAddToPolicyByDefault` | When enabled, the "Allow for all future sessions" option becomes the default choice for low-risk tools in trusted workspaces. | `false` |
128
129
  | Blocks extensions from Git | `security.blockGitExtensions` | Blocks installing and loading extensions from Git. | `false` |
129
130
  | Extension Source Regex Allowlist | `security.allowedExtensions` | List of Regex patterns for allowed extensions. If nonempty, only extensions that match the patterns in this list are allowed. Overrides the blockGitExtensions setting. | `[]` |
130
131
  | Folder Trust | `security.folderTrust.enabled` | Setting to track whether Folder trust is enabled. | `true` |