@google/gemini-cli-core 0.27.0-preview.0 → 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.
- package/dist/docs/changelogs/index.md +17 -0
- package/dist/docs/changelogs/latest.md +314 -346
- package/dist/docs/changelogs/preview.md +412 -307
- package/dist/docs/cli/cli-reference.md +101 -0
- package/dist/docs/cli/commands.md +4 -4
- package/dist/docs/cli/keyboard-shortcuts.md +12 -11
- package/dist/docs/cli/rewind.md +51 -0
- package/dist/docs/cli/settings.md +1 -0
- package/dist/docs/cli/skills.md +3 -2
- package/dist/docs/core/policy-engine.md +5 -0
- package/dist/docs/get-started/configuration.md +4 -5
- package/dist/docs/sidebar.json +10 -2
- package/dist/docs/tools/mcp-server.md +13 -2
- package/dist/google-gemini-cli-core-0.28.0-nightly.20260128.adc8e11bb.tgz +0 -0
- package/dist/src/code_assist/types.d.ts +5 -5
- package/dist/src/code_assist/types.js +1 -1
- package/dist/src/code_assist/types.js.map +1 -1
- package/dist/src/config/config.d.ts +52 -0
- package/dist/src/config/config.js.map +1 -1
- package/dist/src/generated/git-commit.d.ts +2 -2
- package/dist/src/generated/git-commit.js +2 -2
- package/dist/src/generated/git-commit.js.map +1 -1
- package/dist/src/hooks/hookEventHandler.d.ts +6 -0
- package/dist/src/hooks/hookEventHandler.js +30 -7
- package/dist/src/hooks/hookEventHandler.js.map +1 -1
- package/dist/src/hooks/hookEventHandler.test.js +43 -0
- package/dist/src/hooks/hookEventHandler.test.js.map +1 -1
- package/dist/src/ide/detect-ide.d.ts +4 -0
- package/dist/src/ide/detect-ide.js +4 -0
- package/dist/src/ide/detect-ide.js.map +1 -1
- package/dist/src/ide/detect-ide.test.js +14 -0
- package/dist/src/ide/detect-ide.test.js.map +1 -1
- package/dist/src/ide/ide-installer.js +74 -3
- package/dist/src/ide/ide-installer.js.map +1 -1
- package/dist/src/ide/ide-installer.test.js +29 -0
- package/dist/src/ide/ide-installer.test.js.map +1 -1
- package/dist/src/policy/toml-loader.js +2 -0
- package/dist/src/policy/toml-loader.js.map +1 -1
- package/dist/src/policy/toml-loader.test.js +14 -0
- package/dist/src/policy/toml-loader.test.js.map +1 -1
- package/dist/src/policy/types.d.ts +5 -0
- package/dist/src/scheduler/policy.d.ts +2 -2
- package/dist/src/scheduler/policy.js +8 -3
- package/dist/src/scheduler/policy.js.map +1 -1
- package/dist/src/scheduler/policy.test.js +6 -6
- package/dist/src/scheduler/policy.test.js.map +1 -1
- package/dist/src/scheduler/scheduler.js +3 -2
- package/dist/src/scheduler/scheduler.js.map +1 -1
- package/dist/src/scheduler/scheduler.test.js +58 -8
- package/dist/src/scheduler/scheduler.test.js.map +1 -1
- package/dist/src/services/chatRecordingService.d.ts +7 -0
- package/dist/src/services/chatRecordingService.js +17 -0
- package/dist/src/services/chatRecordingService.js.map +1 -1
- package/dist/src/services/chatRecordingService.test.js +56 -0
- package/dist/src/services/chatRecordingService.test.js.map +1 -1
- package/dist/src/services/environmentSanitization.js +3 -0
- package/dist/src/services/environmentSanitization.js.map +1 -1
- package/dist/src/services/environmentSanitization.test.js +3 -0
- package/dist/src/services/environmentSanitization.test.js.map +1 -1
- package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js +11 -0
- package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js.map +1 -1
- package/dist/src/tools/mcp-client.js +20 -3
- package/dist/src/tools/mcp-client.js.map +1 -1
- package/dist/src/tools/mcp-client.test.js +65 -2
- package/dist/src/tools/mcp-client.test.js.map +1 -1
- package/dist/src/utils/fileUtils.js +7 -5
- package/dist/src/utils/fileUtils.js.map +1 -1
- package/dist/src/utils/fileUtils.test.js +32 -3
- package/dist/src/utils/fileUtils.test.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +1 -1
|
@@ -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 **
|
|
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 **
|
|
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. | `
|
|
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` |
|
package/dist/docs/cli/skills.md
CHANGED
|
@@ -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
|
|
95
|
-
|
|
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).
|
package/dist/docs/sidebar.json
CHANGED
|
@@ -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
|
-
{
|
|
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
|
-
|
|
266
|
+
unmanagedCapabilitiesEnabled: z.ZodOptional<z.ZodBoolean>;
|
|
267
267
|
}, "strip", z.ZodTypeAny, {
|
|
268
268
|
extensionsSetting?: {
|
|
269
269
|
extensionsEnabled?: boolean | undefined;
|
|
270
270
|
} | undefined;
|
|
271
|
-
|
|
271
|
+
unmanagedCapabilitiesEnabled?: boolean | undefined;
|
|
272
272
|
}, {
|
|
273
273
|
extensionsSetting?: {
|
|
274
274
|
extensionsEnabled?: boolean | undefined;
|
|
275
275
|
} | undefined;
|
|
276
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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,
|
|
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;
|