@google/gemini-cli-core 0.27.0-preview.1 → 0.28.0-nightly.20260129.9bb175a50

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 (72) hide show
  1. package/dist/docs/changelogs/index.md +17 -0
  2. package/dist/docs/changelogs/latest.md +314 -346
  3. package/dist/docs/changelogs/preview.md +412 -307
  4. package/dist/docs/cli/cli-reference.md +101 -0
  5. package/dist/docs/cli/commands.md +4 -4
  6. package/dist/docs/cli/keyboard-shortcuts.md +12 -11
  7. package/dist/docs/cli/rewind.md +51 -0
  8. package/dist/docs/cli/settings.md +1 -0
  9. package/dist/docs/cli/skills.md +3 -2
  10. package/dist/docs/core/policy-engine.md +5 -0
  11. package/dist/docs/get-started/configuration.md +4 -5
  12. package/dist/docs/sidebar.json +10 -2
  13. package/dist/docs/tools/mcp-server.md +13 -2
  14. package/dist/google-gemini-cli-core-0.28.0-nightly.20260128.adc8e11bb.tgz +0 -0
  15. package/dist/src/code_assist/types.d.ts +5 -5
  16. package/dist/src/code_assist/types.js +1 -1
  17. package/dist/src/code_assist/types.js.map +1 -1
  18. package/dist/src/config/config.d.ts +52 -0
  19. package/dist/src/config/config.js.map +1 -1
  20. package/dist/src/generated/git-commit.d.ts +2 -2
  21. package/dist/src/generated/git-commit.js +2 -2
  22. package/dist/src/generated/git-commit.js.map +1 -1
  23. package/dist/src/hooks/hookEventHandler.d.ts +6 -0
  24. package/dist/src/hooks/hookEventHandler.js +30 -7
  25. package/dist/src/hooks/hookEventHandler.js.map +1 -1
  26. package/dist/src/hooks/hookEventHandler.test.js +43 -0
  27. package/dist/src/hooks/hookEventHandler.test.js.map +1 -1
  28. package/dist/src/ide/detect-ide.d.ts +4 -0
  29. package/dist/src/ide/detect-ide.js +4 -0
  30. package/dist/src/ide/detect-ide.js.map +1 -1
  31. package/dist/src/ide/detect-ide.test.js +14 -0
  32. package/dist/src/ide/detect-ide.test.js.map +1 -1
  33. package/dist/src/ide/ide-installer.js +74 -3
  34. package/dist/src/ide/ide-installer.js.map +1 -1
  35. package/dist/src/ide/ide-installer.test.js +29 -0
  36. package/dist/src/ide/ide-installer.test.js.map +1 -1
  37. package/dist/src/policy/toml-loader.js +2 -0
  38. package/dist/src/policy/toml-loader.js.map +1 -1
  39. package/dist/src/policy/toml-loader.test.js +14 -0
  40. package/dist/src/policy/toml-loader.test.js.map +1 -1
  41. package/dist/src/policy/types.d.ts +5 -0
  42. package/dist/src/scheduler/policy.d.ts +2 -2
  43. package/dist/src/scheduler/policy.js +8 -3
  44. package/dist/src/scheduler/policy.js.map +1 -1
  45. package/dist/src/scheduler/policy.test.js +6 -6
  46. package/dist/src/scheduler/policy.test.js.map +1 -1
  47. package/dist/src/scheduler/scheduler.js +3 -2
  48. package/dist/src/scheduler/scheduler.js.map +1 -1
  49. package/dist/src/scheduler/scheduler.test.js +58 -8
  50. package/dist/src/scheduler/scheduler.test.js.map +1 -1
  51. package/dist/src/services/chatRecordingService.d.ts +7 -0
  52. package/dist/src/services/chatRecordingService.js +17 -0
  53. package/dist/src/services/chatRecordingService.js.map +1 -1
  54. package/dist/src/services/chatRecordingService.test.js +56 -0
  55. package/dist/src/services/chatRecordingService.test.js.map +1 -1
  56. package/dist/src/services/environmentSanitization.js +3 -0
  57. package/dist/src/services/environmentSanitization.js.map +1 -1
  58. package/dist/src/services/environmentSanitization.test.js +3 -0
  59. package/dist/src/services/environmentSanitization.test.js.map +1 -1
  60. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js +11 -0
  61. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js.map +1 -1
  62. package/dist/src/tools/mcp-client.js +20 -3
  63. package/dist/src/tools/mcp-client.js.map +1 -1
  64. package/dist/src/tools/mcp-client.test.js +65 -2
  65. package/dist/src/tools/mcp-client.test.js.map +1 -1
  66. package/dist/src/utils/fileUtils.js +7 -5
  67. package/dist/src/utils/fileUtils.js.map +1 -1
  68. package/dist/src/utils/fileUtils.test.js +32 -3
  69. package/dist/src/utils/fileUtils.test.js.map +1 -1
  70. package/dist/tsconfig.tsbuildinfo +1 -1
  71. package/package.json +1 -1
  72. package/dist/google-gemini-cli-core-0.27.0-preview.0.tgz +0 -0
@@ -0,0 +1,101 @@
1
+ # CLI cheatsheet
2
+
3
+ This page provides a reference for commonly used Gemini CLI commands, options,
4
+ and parameters.
5
+
6
+ ## CLI commands
7
+
8
+ | Command | Description | Example |
9
+ | ---------------------------------- | ---------------------------------- | --------------------------------------------------- |
10
+ | `gemini` | Start interactive REPL | `gemini` |
11
+ | `gemini "query"` | Query non-interactively, then exit | `gemini "explain this project"` |
12
+ | `gemini -p "query"` | Query via SDK, then exit | `gemini -p "explain this function"` |
13
+ | `cat file \| gemini -p "query"` | Process piped content | `cat logs.txt \| gemini -p "explain"` |
14
+ | `gemini -i "query"` | Execute and continue interactively | `gemini -i "What is the purpose of this project?"` |
15
+ | `gemini -r "latest"` | Continue most recent session | `gemini -r "latest"` |
16
+ | `gemini -r "latest" "query"` | Continue session with a new prompt | `gemini -r "latest" "Check for type errors"` |
17
+ | `gemini -r "<session-id>" "query"` | Resume session by ID | `gemini -r "abc123" "Finish this PR"` |
18
+ | `gemini update` | Update to latest version | `gemini update` |
19
+ | `gemini extensions` | Manage extensions | See [Extensions Management](#extensions-management) |
20
+ | `gemini mcp` | Configure MCP servers | See [MCP Server Management](#mcp-server-management) |
21
+
22
+ ### Positional arguments
23
+
24
+ | Argument | Type | Description |
25
+ | -------- | ----------------- | ------------------------------------------------------------------------------------------------------------------ |
26
+ | `query` | string (variadic) | Positional prompt. Defaults to one-shot mode. Use `-i/--prompt-interactive` to execute and continue interactively. |
27
+
28
+ ## CLI Options
29
+
30
+ | Option | Alias | Type | Default | Description |
31
+ | -------------------------------- | ----- | ------- | --------- | ---------------------------------------------------------------------------------------------------------- |
32
+ | `--debug` | `-d` | boolean | `false` | Run in debug mode with verbose logging |
33
+ | `--version` | `-v` | - | - | Show CLI version number and exit |
34
+ | `--help` | `-h` | - | - | Show help information |
35
+ | `--model` | `-m` | string | `auto` | Model to use. See [Model Selection](#model-selection) for available values. |
36
+ | `--prompt` | `-p` | string | - | Prompt text. Appended to stdin input if provided. **Deprecated:** Use positional arguments instead. |
37
+ | `--prompt-interactive` | `-i` | string | - | Execute prompt and continue in interactive mode |
38
+ | `--sandbox` | `-s` | boolean | `false` | Run in a sandboxed environment for safer execution |
39
+ | `--approval-mode` | - | string | `default` | Approval mode for tool execution. Choices: `default`, `auto_edit`, `yolo` |
40
+ | `--yolo` | `-y` | boolean | `false` | **Deprecated.** Auto-approve all actions. Use `--approval-mode=yolo` instead. |
41
+ | `--experimental-acp` | - | boolean | - | Start in ACP (Agent Code Pilot) mode. **Experimental feature.** |
42
+ | `--experimental-zed-integration` | - | boolean | - | Run in Zed editor integration mode. **Experimental feature.** |
43
+ | `--allowed-mcp-server-names` | - | array | - | Allowed MCP server names (comma-separated or multiple flags) |
44
+ | `--allowed-tools` | - | array | - | Tools that are allowed to run without confirmation (comma-separated or multiple flags) |
45
+ | `--extensions` | `-e` | array | - | List of extensions to use. If not provided, all extensions are enabled (comma-separated or multiple flags) |
46
+ | `--list-extensions` | `-l` | boolean | - | List all available extensions and exit |
47
+ | `--resume` | `-r` | string | - | Resume a previous session. Use `"latest"` for most recent or index number (e.g. `--resume 5`) |
48
+ | `--list-sessions` | - | boolean | - | List available sessions for the current project and exit |
49
+ | `--delete-session` | - | string | - | Delete a session by index number (use `--list-sessions` to see available sessions) |
50
+ | `--include-directories` | - | array | - | Additional directories to include in the workspace (comma-separated or multiple flags) |
51
+ | `--screen-reader` | - | boolean | - | Enable screen reader mode for accessibility |
52
+ | `--output-format` | `-o` | string | `text` | The format of the CLI output. Choices: `text`, `json`, `stream-json` |
53
+
54
+ ## Model selection
55
+
56
+ The `--model` (or `-m`) flag allows you to specify which Gemini model to use.
57
+ You can use either model aliases (user-friendly names) or concrete model names.
58
+
59
+ ### Model aliases
60
+
61
+ These are convenient shortcuts that map to specific models:
62
+
63
+ | Alias | Resolves To | Description |
64
+ | ------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
65
+ | `auto` | `gemini-2.5-pro` or `gemini-3-pro-preview` | **Default.** Resolves to the preview model if preview features are enabled, otherwise resolves to the standard pro model. |
66
+ | `pro` | `gemini-2.5-pro` or `gemini-3-pro-preview` | For complex reasoning tasks. Uses preview model if enabled. |
67
+ | `flash` | `gemini-2.5-flash` | Fast, balanced model for most tasks. |
68
+ | `flash-lite` | `gemini-2.5-flash-lite` | Fastest model for simple tasks. |
69
+
70
+ ## Extensions management
71
+
72
+ | Command | Description | Example |
73
+ | -------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------ |
74
+ | `gemini extensions install <source>` | Install extension from Git URL or local path | `gemini extensions install https://github.com/user/my-extension` |
75
+ | `gemini extensions install <source> --ref <ref>` | Install from specific branch/tag/commit | `gemini extensions install https://github.com/user/my-extension --ref develop` |
76
+ | `gemini extensions install <source> --auto-update` | Install with auto-update enabled | `gemini extensions install https://github.com/user/my-extension --auto-update` |
77
+ | `gemini extensions uninstall <name>` | Uninstall one or more extensions | `gemini extensions uninstall my-extension` |
78
+ | `gemini extensions list` | List all installed extensions | `gemini extensions list` |
79
+ | `gemini extensions update <name>` | Update a specific extension | `gemini extensions update my-extension` |
80
+ | `gemini extensions update --all` | Update all extensions | `gemini extensions update --all` |
81
+ | `gemini extensions enable <name>` | Enable an extension | `gemini extensions enable my-extension` |
82
+ | `gemini extensions disable <name>` | Disable an extension | `gemini extensions disable my-extension` |
83
+ | `gemini extensions link <path>` | Link local extension for development | `gemini extensions link /path/to/extension` |
84
+ | `gemini extensions new <path>` | Create new extension from template | `gemini extensions new ./my-extension` |
85
+ | `gemini extensions validate <path>` | Validate extension structure | `gemini extensions validate ./my-extension` |
86
+
87
+ See [Extensions Documentation](../extensions/index.md) for more details.
88
+
89
+ ## MCP server management
90
+
91
+ | Command | Description | Example |
92
+ | ------------------------------------------------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------- |
93
+ | `gemini mcp add <name> <command>` | Add stdio-based MCP server | `gemini mcp add github npx -y @modelcontextprotocol/server-github` |
94
+ | `gemini mcp add <name> <url> --transport http` | Add HTTP-based MCP server | `gemini mcp add api-server http://localhost:3000 --transport http` |
95
+ | `gemini mcp add <name> <command> --env KEY=value` | Add with environment variables | `gemini mcp add slack node server.js --env SLACK_TOKEN=xoxb-xxx` |
96
+ | `gemini mcp add <name> <command> --scope user` | Add with user scope | `gemini mcp add db node db-server.js --scope user` |
97
+ | `gemini mcp add <name> <command> --include-tools tool1,tool2` | Add with specific tools | `gemini mcp add github npx -y @modelcontextprotocol/server-github --include-tools list_repos,get_pr` |
98
+ | `gemini mcp remove <name>` | Remove an MCP server | `gemini mcp remove github` |
99
+ | `gemini mcp list` | List all configured MCP servers | `gemini mcp list` |
100
+
101
+ See [MCP Server Integration](../tools/mcp-server.md) for more details.
@@ -288,12 +288,12 @@ please see the dedicated [Custom Commands documentation](./custom-commands.md).
288
288
  These shortcuts apply directly to the input prompt for text manipulation.
289
289
 
290
290
  - **Undo:**
291
- - **Keyboard shortcut:** Press **Ctrl+z** to undo the last action in the input
292
- prompt.
291
+ - **Keyboard shortcut:** Press **Cmd+z** or **Alt+z** to undo the last action
292
+ in the input prompt.
293
293
 
294
294
  - **Redo:**
295
- - **Keyboard shortcut:** Press **Ctrl+Shift+Z** to redo the last undone action
296
- in the input prompt.
295
+ - **Keyboard shortcut:** Press **Shift+Cmd+Z** or **Shift+Alt+Z** to redo the
296
+ last undone action in the input prompt.
297
297
 
298
298
  ## At commands (`@`)
299
299
 
@@ -30,17 +30,17 @@ available combinations.
30
30
 
31
31
  #### Editing
32
32
 
33
- | Action | Keys |
34
- | ------------------------------------------------ | --------------------------------------------------------- |
35
- | Delete from the cursor to the end of the line. | `Ctrl + K` |
36
- | Delete from the cursor to the start of the line. | `Ctrl + U` |
37
- | Clear all text in the input field. | `Ctrl + C` |
38
- | Delete the previous word. | `Ctrl + Backspace`<br />`Alt + Backspace`<br />`Ctrl + W` |
39
- | Delete the next word. | `Ctrl + Delete`<br />`Alt + Delete` |
40
- | Delete the character to the left. | `Backspace`<br />`Ctrl + H` |
41
- | Delete the character to the right. | `Delete`<br />`Ctrl + D` |
42
- | Undo the most recent text edit. | `Ctrl + Z (no Shift)` |
43
- | Redo the most recent undone text edit. | `Shift + Ctrl + Z` |
33
+ | Action | Keys |
34
+ | ------------------------------------------------ | ---------------------------------------------------------------- |
35
+ | Delete from the cursor to the end of the line. | `Ctrl + K` |
36
+ | Delete from the cursor to the start of the line. | `Ctrl + U` |
37
+ | Clear all text in the input field. | `Ctrl + C` |
38
+ | Delete the previous word. | `Ctrl + Backspace`<br />`Alt + Backspace`<br />`Ctrl + W` |
39
+ | Delete the next word. | `Ctrl + Delete`<br />`Alt + Delete` |
40
+ | Delete the character to the left. | `Backspace`<br />`Ctrl + H` |
41
+ | Delete the character to the right. | `Delete`<br />`Ctrl + D` |
42
+ | Undo the most recent text edit. | `Cmd + Z (no Shift)`<br />`Alt + Z (no Shift)` |
43
+ | Redo the most recent undone text edit. | `Shift + Ctrl + Z`<br />`Shift + Cmd + Z`<br />`Shift + Alt + Z` |
44
44
 
45
45
  #### Scrolling
46
46
 
@@ -110,6 +110,7 @@ available combinations.
110
110
  | Focus the Gemini input from the shell input. | `Tab` |
111
111
  | Clear the terminal screen and redraw the UI. | `Ctrl + L` |
112
112
  | Restart the application. | `R` |
113
+ | Suspend the application (not yet implemented). | `Ctrl + Z` |
113
114
 
114
115
  <!-- KEYBINDINGS-AUTOGEN:END -->
115
116
 
@@ -0,0 +1,51 @@
1
+ # Rewind
2
+
3
+ The `/rewind` command allows you to go back to a previous state in your
4
+ conversation and, optionally, revert any file changes made by the AI during
5
+ those interactions. This is a powerful tool for undoing mistakes, exploring
6
+ different approaches, or simply cleaning up your session history.
7
+
8
+ ## Usage
9
+
10
+ To use the rewind feature, simply type `/rewind` into the input prompt and press
11
+ **Enter**.
12
+
13
+ Alternatively, you can use the keyboard shortcut: **Press `Esc` twice**.
14
+
15
+ ## Interface
16
+
17
+ When you trigger a rewind, an interactive list of your previous interactions
18
+ appears.
19
+
20
+ 1. **Select Interaction:** Use the **Up/Down arrow keys** to navigate through
21
+ the list. The most recent interactions are at the bottom.
22
+ 2. **Preview:** As you select an interaction, you'll see a preview of the user
23
+ prompt and, if applicable, the number of files changed during that step.
24
+ 3. **Confirm Selection:** Press **Enter** on the interaction you want to rewind
25
+ back to.
26
+ 4. **Action Selection:** After selecting an interaction, you'll be presented
27
+ with a confirmation dialog with up to three options:
28
+ - **Rewind conversation and revert code changes:** Reverts both the chat
29
+ history and the file modifications to the state before the selected
30
+ interaction.
31
+ - **Rewind conversation:** Only reverts the chat history. File changes are
32
+ kept.
33
+ - **Revert code changes:** Only reverts the file modifications. The chat
34
+ history is kept.
35
+ - **Do nothing (esc):** Cancels the rewind operation.
36
+
37
+ If no code changes were made since the selected point, the options related to
38
+ reverting code changes will be hidden.
39
+
40
+ ## Key Considerations
41
+
42
+ - **Destructive Action:** Rewinding is a destructive action for your current
43
+ session history and potentially your files. Use it with care.
44
+ - **Agent Awareness:** When you rewind the conversation, the AI model loses all
45
+ memory of the interactions that were removed. If you only revert code changes,
46
+ you may need to inform the model that the files have changed.
47
+ - **Manual Edits:** Rewinding only affects file changes made by the AI's edit
48
+ tools. It does **not** undo manual edits you've made or changes triggered by
49
+ the shell tool (`!`).
50
+ - **Compression:** Rewind works across chat compression points by reconstructing
51
+ the history from stored session data.
@@ -57,6 +57,7 @@ they appear in the UI.
57
57
  | Show Line Numbers | `ui.showLineNumbers` | Show line numbers in the chat. | `true` |
58
58
  | Show Citations | `ui.showCitations` | Show citations for generated text in the chat. | `false` |
59
59
  | Show Model Info In Chat | `ui.showModelInfoInChat` | Show the model name in the chat for each model turn. | `false` |
60
+ | Show User Identity | `ui.showUserIdentity` | Show the logged-in user's identity (e.g. email) in the UI. | `true` |
60
61
  | Use Alternate Screen Buffer | `ui.useAlternateBuffer` | Use an alternate screen buffer for the UI, preserving shell history. | `false` |
61
62
  | Use Background Color | `ui.useBackgroundColor` | Whether to use background colors in the UI. | `true` |
62
63
  | 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` |
@@ -91,8 +91,9 @@ gemini skills disable my-expertise --scope workspace
91
91
 
92
92
  ## Creating a Skill
93
93
 
94
- A skill is a directory containing a `SKILL.md` file at its root. This file uses
95
- YAML frontmatter for metadata and Markdown for instructions.
94
+ A skill is a directory containing a `SKILL.md` file at its root. This file
95
+ serves as the entry point for your skill and uses YAML frontmatter for metadata
96
+ and Markdown for instructions.
96
97
 
97
98
  ### Folder Structure
98
99
 
@@ -210,6 +210,10 @@ decision = "ask_user"
210
210
  # The priority of the rule, from 0 to 999.
211
211
  priority = 10
212
212
 
213
+ # (Optional) A custom message to display when a tool call is denied by this rule.
214
+ # This message is returned to the model and user, useful for explaining *why* it was denied.
215
+ deny_message = "Deletion is permanent"
216
+
213
217
  # (Optional) An array of approval modes where this rule is active.
214
218
  modes = ["autoEdit"]
215
219
  ```
@@ -282,6 +286,7 @@ only the `mcpName`.
282
286
  mcpName = "untrusted-server"
283
287
  decision = "deny"
284
288
  priority = 500
289
+ deny_message = "This server is not trusted by the admin."
285
290
  ```
286
291
 
287
292
  ## Default policies
@@ -244,6 +244,10 @@ their corresponding top-level category object in your `settings.json` file.
244
244
  - **Description:** Show the model name in the chat for each model turn.
245
245
  - **Default:** `false`
246
246
 
247
+ - **`ui.showUserIdentity`** (boolean):
248
+ - **Description:** Show the logged-in user's identity (e.g. email) in the UI.
249
+ - **Default:** `true`
250
+
247
251
  - **`ui.useAlternateBuffer`** (boolean):
248
252
  - **Description:** Use an alternate screen buffer for the UI, preserving shell
249
253
  history.
@@ -869,11 +873,6 @@ their corresponding top-level category object in your `settings.json` file.
869
873
  - **Default:** `false`
870
874
  - **Requires restart:** Yes
871
875
 
872
- - **`experimental.skills`** (boolean):
873
- - **Description:** [Deprecated] Enable Agent Skills (experimental).
874
- - **Default:** `false`
875
- - **Requires restart:** Yes
876
-
877
876
  - **`experimental.useOSC52Paste`** (boolean):
878
877
  - **Description:** Use OSC 52 sequence for pasting instead of clipboardy
879
878
  (useful for remote sessions).
@@ -7,7 +7,8 @@
7
7
  { "label": "Installation", "slug": "docs/get-started/installation" },
8
8
  { "label": "Authentication", "slug": "docs/get-started/authentication" },
9
9
  { "label": "Examples", "slug": "docs/get-started/examples" },
10
- { "label": "Gemini 3 (preview)", "slug": "docs/get-started/gemini-3" }
10
+ { "label": "Gemini 3 (preview)", "slug": "docs/get-started/gemini-3" },
11
+ { "label": "CLI Reference", "slug": "docs/cli/cli-reference" }
11
12
  ]
12
13
  },
13
14
  {
@@ -118,7 +119,14 @@
118
119
  "items": [
119
120
  { "label": "FAQ", "slug": "docs/faq" },
120
121
  { "label": "Quota and pricing", "slug": "docs/quota-and-pricing" },
121
- { "label": "Release notes", "slug": "docs/changelogs/" },
122
+ {
123
+ "label": "Releases",
124
+ "items": [
125
+ { "label": "Release notes", "slug": "docs/changelogs/" },
126
+ { "label": "Stable release", "slug": "docs/changelogs/latest" },
127
+ { "label": "Preview release", "slug": "docs/changelogs/preview" }
128
+ ]
129
+ },
122
130
  { "label": "Terms and privacy", "slug": "docs/tos-privacy" },
123
131
  { "label": "Troubleshooting", "slug": "docs/troubleshooting" },
124
132
  { "label": "Uninstall", "slug": "docs/cli/uninstall" }
@@ -739,10 +739,21 @@ The MCP integration tracks several states:
739
739
  cautiously and only for servers you completely control
740
740
  - **Access tokens:** Be security-aware when configuring environment variables
741
741
  containing API keys or tokens
742
+ - **Environment variable redaction:** By default, the Gemini CLI redacts
743
+ sensitive environment variables (such as `GEMINI_API_KEY`, `GOOGLE_API_KEY`,
744
+ and variables matching patterns like `*TOKEN*`, `*SECRET*`, `*PASSWORD*`) when
745
+ spawning MCP servers using the `stdio` transport. This prevents unintended
746
+ exposure of your credentials to third-party servers.
747
+ - **Explicit environment variables:** If you need to pass a specific environment
748
+ variable to an MCP server, you should define it explicitly in the `env`
749
+ property of the server configuration in `settings.json`.
742
750
  - **Sandbox compatibility:** When using sandboxing, ensure MCP servers are
743
- available within the sandbox environment
751
+ available within the sandbox environment.
744
752
  - **Private data:** Using broadly scoped personal access tokens can lead to
745
- information leakage between repositories
753
+ information leakage between repositories.
754
+ - **Untrusted servers:** Be extremely cautious when adding MCP servers from
755
+ untrusted or third-party sources. Malicious servers could attempt to
756
+ exfiltrate data or perform unauthorized actions through the tools they expose.
746
757
 
747
758
  ### Performance and resource management
748
759
 
@@ -263,17 +263,17 @@ export declare const FetchAdminControlsResponseSchema: z.ZodObject<{
263
263
  }, {
264
264
  extensionsEnabled?: boolean | undefined;
265
265
  }>>;
266
- advancedFeaturesEnabled: z.ZodOptional<z.ZodBoolean>;
266
+ unmanagedCapabilitiesEnabled: z.ZodOptional<z.ZodBoolean>;
267
267
  }, "strip", z.ZodTypeAny, {
268
268
  extensionsSetting?: {
269
269
  extensionsEnabled?: boolean | undefined;
270
270
  } | undefined;
271
- advancedFeaturesEnabled?: boolean | undefined;
271
+ unmanagedCapabilitiesEnabled?: boolean | undefined;
272
272
  }, {
273
273
  extensionsSetting?: {
274
274
  extensionsEnabled?: boolean | undefined;
275
275
  } | undefined;
276
- advancedFeaturesEnabled?: boolean | undefined;
276
+ unmanagedCapabilitiesEnabled?: boolean | undefined;
277
277
  }>>;
278
278
  }, "strip", z.ZodTypeAny, {
279
279
  secureModeEnabled?: boolean | undefined;
@@ -285,7 +285,7 @@ export declare const FetchAdminControlsResponseSchema: z.ZodObject<{
285
285
  extensionsSetting?: {
286
286
  extensionsEnabled?: boolean | undefined;
287
287
  } | undefined;
288
- advancedFeaturesEnabled?: boolean | undefined;
288
+ unmanagedCapabilitiesEnabled?: boolean | undefined;
289
289
  } | undefined;
290
290
  }, {
291
291
  secureModeEnabled?: boolean | undefined;
@@ -297,7 +297,7 @@ export declare const FetchAdminControlsResponseSchema: z.ZodObject<{
297
297
  extensionsSetting?: {
298
298
  extensionsEnabled?: boolean | undefined;
299
299
  } | undefined;
300
- advancedFeaturesEnabled?: boolean | undefined;
300
+ unmanagedCapabilitiesEnabled?: boolean | undefined;
301
301
  } | undefined;
302
302
  }>;
303
303
  export {};
@@ -78,7 +78,7 @@ const ExtensionsSettingSchema = z.object({
78
78
  });
79
79
  const CliFeatureSettingSchema = z.object({
80
80
  extensionsSetting: ExtensionsSettingSchema.optional(),
81
- advancedFeaturesEnabled: z.boolean().optional(),
81
+ unmanagedCapabilitiesEnabled: z.boolean().optional(),
82
82
  });
83
83
  const McpSettingSchema = z.object({
84
84
  mcpEnabled: z.boolean().optional(),
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/code_assist/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqFxB;;;GAGG;AACH,MAAM,CAAN,IAAY,wBAYX;AAZD,WAAY,wBAAwB;IAClC,uBAAuB;IACvB,uDAA2B,CAAA;IAC3B,qEAAyC,CAAA;IACzC,iEAAqC,CAAA;IACrC,6DAAiC,CAAA;IACjC,qEAAyC,CAAA;IACzC,+CAAmB,CAAA;IACnB,iEAAqC,CAAA;IACrC,yEAA6C,CAAA;IAC7C,uEAA2C,CAAA;IAC3C,qBAAqB;AACvB,CAAC,EAZW,wBAAwB,KAAxB,wBAAwB,QAYnC;AACD;;;;GAIG;AACH,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,gCAAkB,CAAA;IAClB,oCAAsB,CAAA;IACtB,wCAA0B,CAAA;AAC5B,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AA0CD;;;;GAIG;AACH,MAAM,CAAN,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC/B,4CAAmB,CAAA;IACnB,0CAAiB,CAAA;IACjB,4CAAmB,CAAA;IACnB,wCAAe,CAAA;AACjB,CAAC,EALW,qBAAqB,KAArB,qBAAqB,QAKhC;AA2ED,MAAM,CAAN,IAAY,kCAWX;AAXD,WAAY,kCAAkC;IAC5C,iGAAW,CAAA;IACX,mGAAY,CAAA;IACZ,uGAAc,CAAA;IACd,2FAAQ,CAAA;IACR,+FAAU,CAAA;IACV,qHAAqB,CAAA;IACrB,uGAAc,CAAA;IACd,yGAAe,CAAA;IACf,2FAAQ,CAAA;IACR,2GAAgB,CAAA;AAClB,CAAC,EAXW,kCAAkC,KAAlC,kCAAkC,QAW7C;AAED,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,yFAA6B,CAAA;IAC7B,mFAA0B,CAAA;IAC1B,6FAA+B,CAAA;IAC/B,qFAA2B,CAAA;IAC3B,6EAAuB,CAAA;AACzB,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB;AAED,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,yGAAiC,CAAA;IACjC,qDAAO,CAAA;IACP,6DAAW,CAAA;IACX,yDAAS,CAAA;AACX,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAkCD,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,iBAAiB,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IACrD,uBAAuB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACvC,iBAAiB,EAAE,uBAAuB,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/code_assist/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqFxB;;;GAGG;AACH,MAAM,CAAN,IAAY,wBAYX;AAZD,WAAY,wBAAwB;IAClC,uBAAuB;IACvB,uDAA2B,CAAA;IAC3B,qEAAyC,CAAA;IACzC,iEAAqC,CAAA;IACrC,6DAAiC,CAAA;IACjC,qEAAyC,CAAA;IACzC,+CAAmB,CAAA;IACnB,iEAAqC,CAAA;IACrC,yEAA6C,CAAA;IAC7C,uEAA2C,CAAA;IAC3C,qBAAqB;AACvB,CAAC,EAZW,wBAAwB,KAAxB,wBAAwB,QAYnC;AACD;;;;GAIG;AACH,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,gCAAkB,CAAA;IAClB,oCAAsB,CAAA;IACtB,wCAA0B,CAAA;AAC5B,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AA0CD;;;;GAIG;AACH,MAAM,CAAN,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC/B,4CAAmB,CAAA;IACnB,0CAAiB,CAAA;IACjB,4CAAmB,CAAA;IACnB,wCAAe,CAAA;AACjB,CAAC,EALW,qBAAqB,KAArB,qBAAqB,QAKhC;AA2ED,MAAM,CAAN,IAAY,kCAWX;AAXD,WAAY,kCAAkC;IAC5C,iGAAW,CAAA;IACX,mGAAY,CAAA;IACZ,uGAAc,CAAA;IACd,2FAAQ,CAAA;IACR,+FAAU,CAAA;IACV,qHAAqB,CAAA;IACrB,uGAAc,CAAA;IACd,yGAAe,CAAA;IACf,2FAAQ,CAAA;IACR,2GAAgB,CAAA;AAClB,CAAC,EAXW,kCAAkC,KAAlC,kCAAkC,QAW7C;AAED,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,yFAA6B,CAAA;IAC7B,mFAA0B,CAAA;IAC1B,6FAA+B,CAAA;IAC/B,qFAA2B,CAAA;IAC3B,6EAAuB,CAAA;AACzB,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB;AAED,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,yGAAiC,CAAA;IACjC,qDAAO,CAAA;IACP,6DAAW,CAAA;IACX,yDAAS,CAAA;AACX,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAkCD,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,iBAAiB,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IACrD,4BAA4B,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACvC,iBAAiB,EAAE,uBAAuB,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC"}
@@ -93,6 +93,53 @@ export interface AgentOverride {
93
93
  export interface AgentSettings {
94
94
  overrides?: Record<string, AgentOverride>;
95
95
  }
96
+ export interface CustomTheme {
97
+ type: 'custom';
98
+ name: string;
99
+ text?: {
100
+ primary?: string;
101
+ secondary?: string;
102
+ link?: string;
103
+ accent?: string;
104
+ response?: string;
105
+ };
106
+ background?: {
107
+ primary?: string;
108
+ diff?: {
109
+ added?: string;
110
+ removed?: string;
111
+ };
112
+ };
113
+ border?: {
114
+ default?: string;
115
+ focused?: string;
116
+ };
117
+ ui?: {
118
+ comment?: string;
119
+ symbol?: string;
120
+ gradient?: string[];
121
+ };
122
+ status?: {
123
+ error?: string;
124
+ success?: string;
125
+ warning?: string;
126
+ };
127
+ Background?: string;
128
+ Foreground?: string;
129
+ LightBlue?: string;
130
+ AccentBlue?: string;
131
+ AccentPurple?: string;
132
+ AccentCyan?: string;
133
+ AccentGreen?: string;
134
+ AccentYellow?: string;
135
+ AccentRed?: string;
136
+ DiffAdded?: string;
137
+ DiffRemoved?: string;
138
+ Comment?: string;
139
+ Gray?: string;
140
+ DarkGray?: string;
141
+ GradientColors?: string[];
142
+ }
96
143
  /**
97
144
  * All information required in CLI to handle an extension. Defined in Core so
98
145
  * that the collection of loaded, active, and inactive extensions can be passed
@@ -116,6 +163,11 @@ export interface GeminiCLIExtension {
116
163
  resolvedSettings?: ResolvedExtensionSetting[];
117
164
  skills?: SkillDefinition[];
118
165
  agents?: AgentDefinition[];
166
+ /**
167
+ * Custom themes contributed by this extension.
168
+ * These themes will be registered when the extension is activated.
169
+ */
170
+ themes?: CustomTheme[];
119
171
  }
120
172
  export interface ExtensionInstallMetadata {
121
173
  source: string;