@google/gemini-cli 0.33.0-preview.10 → 0.33.0-preview.11
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/bundle/docs/cli/plan-mode.md +3 -60
- package/bundle/docs/cli/settings.md +1 -1
- package/bundle/docs/reference/commands.md +2 -2
- package/bundle/docs/reference/configuration.md +2 -2
- package/bundle/gemini.js +8 -8
- package/bundle/node_modules/@google/gemini-cli-devtools/package.json +1 -1
- package/package.json +1 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Plan Mode
|
|
1
|
+
# Plan Mode
|
|
2
2
|
|
|
3
3
|
Plan Mode is a read-only environment for architecting robust solutions before
|
|
4
4
|
implementation. It allows you to:
|
|
@@ -8,65 +8,8 @@ implementation. It allows you to:
|
|
|
8
8
|
- **Design:** Understand problems, evaluate trade-offs, and choose a solution.
|
|
9
9
|
- **Plan:** Align on an execution strategy before any code is modified.
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
> suggestions, or encounter issues:
|
|
14
|
-
>
|
|
15
|
-
> - [Open an issue](https://github.com/google-gemini/gemini-cli/issues) on
|
|
16
|
-
> GitHub.
|
|
17
|
-
> - Use the **/bug** command within Gemini CLI to file an issue.
|
|
18
|
-
|
|
19
|
-
- [Enabling Plan Mode](#enabling-plan-mode)
|
|
20
|
-
- [How to use Plan Mode](#how-to-use-plan-mode)
|
|
21
|
-
- [Entering Plan Mode](#entering-plan-mode)
|
|
22
|
-
- [Planning Workflow](#planning-workflow)
|
|
23
|
-
- [Exiting Plan Mode](#exiting-plan-mode)
|
|
24
|
-
- [Commands](#commands)
|
|
25
|
-
- [Tool Restrictions](#tool-restrictions)
|
|
26
|
-
- [Customizing Planning with Skills](#customizing-planning-with-skills)
|
|
27
|
-
- [Customizing Policies](#customizing-policies)
|
|
28
|
-
- [Example: Allow git commands in Plan Mode](#example-allow-git-commands-in-plan-mode)
|
|
29
|
-
- [Example: Enable custom subagents in Plan Mode](#example-enable-custom-subagents-in-plan-mode)
|
|
30
|
-
- [Custom Plan Directory and Policies](#custom-plan-directory-and-policies)
|
|
31
|
-
- [Automatic Model Routing](#automatic-model-routing)
|
|
32
|
-
- [Cleanup](#cleanup)
|
|
33
|
-
|
|
34
|
-
## Enabling Plan Mode
|
|
35
|
-
|
|
36
|
-
To use Plan Mode, enable it via **/settings** (search for **Plan**) or add the
|
|
37
|
-
following to your `settings.json`:
|
|
38
|
-
|
|
39
|
-
```json
|
|
40
|
-
{
|
|
41
|
-
"experimental": {
|
|
42
|
-
"plan": true
|
|
43
|
-
}
|
|
44
|
-
}
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
## How to use Plan Mode
|
|
48
|
-
|
|
49
|
-
### Entering Plan Mode
|
|
50
|
-
|
|
51
|
-
You can configure Gemini CLI to start in Plan Mode by default or enter it
|
|
52
|
-
manually during a session.
|
|
53
|
-
|
|
54
|
-
- **Configuration:** Configure Gemini CLI to start directly in Plan Mode by
|
|
55
|
-
default:
|
|
56
|
-
1. Type `/settings` in the CLI.
|
|
57
|
-
2. Search for **Default Approval Mode**.
|
|
58
|
-
3. Set the value to **Plan**.
|
|
59
|
-
|
|
60
|
-
Alternatively, use the `gemini --approval-mode=plan` CLI flag or manually
|
|
61
|
-
update:
|
|
62
|
-
|
|
63
|
-
```json
|
|
64
|
-
{
|
|
65
|
-
"general": {
|
|
66
|
-
"defaultApprovalMode": "plan"
|
|
67
|
-
}
|
|
68
|
-
}
|
|
69
|
-
```
|
|
11
|
+
Plan Mode is enabled by default. You can manage this setting using the
|
|
12
|
+
`/settings` command.
|
|
70
13
|
|
|
71
14
|
- **Keyboard Shortcut:** Press `Shift+Tab` to cycle through approval modes
|
|
72
15
|
(`Default` -> `Auto-Edit` -> `Plan`).
|
|
@@ -144,7 +144,7 @@ they appear in the UI.
|
|
|
144
144
|
| Enable Tool Output Masking | `experimental.toolOutputMasking.enabled` | Enables tool output masking to save tokens. | `true` |
|
|
145
145
|
| Use OSC 52 Paste | `experimental.useOSC52Paste` | Use OSC 52 for pasting. This may be more robust than the default system when using remote terminal sessions (if your terminal is configured to allow it). | `false` |
|
|
146
146
|
| Use OSC 52 Copy | `experimental.useOSC52Copy` | Use OSC 52 for copying. This may be more robust than the default system when using remote terminal sessions (if your terminal is configured to allow it). | `false` |
|
|
147
|
-
| Plan | `experimental.plan` | Enable
|
|
147
|
+
| Plan | `experimental.plan` | Enable Plan Mode. | `true` |
|
|
148
148
|
| Model Steering | `experimental.modelSteering` | Enable model steering (user hints) to guide the model during tool execution. | `false` |
|
|
149
149
|
| Direct Web Fetch | `experimental.directWebFetch` | Enable web fetch behavior that bypasses LLM summarization. | `false` |
|
|
150
150
|
| Enable Gemma Model Router | `experimental.gemmaModelRouter.enabled` | Enable the Gemma Model Router. Requires a local endpoint serving Gemma via the Gemini API using LiteRT-LM shim. | `false` |
|
|
@@ -268,8 +268,8 @@ Slash commands provide meta-level control over the CLI itself.
|
|
|
268
268
|
|
|
269
269
|
- **Description:** Switch to Plan Mode (read-only) and view the current plan if
|
|
270
270
|
one has been generated.
|
|
271
|
-
- **Note:** This feature
|
|
272
|
-
|
|
271
|
+
- **Note:** This feature is enabled by default. It can be disabled via the
|
|
272
|
+
`experimental.plan` setting in your configuration.
|
|
273
273
|
- **Sub-commands:**
|
|
274
274
|
- **`copy`**:
|
|
275
275
|
- **Description:** Copy the currently approved plan to your clipboard.
|
|
@@ -1010,8 +1010,8 @@ their corresponding top-level category object in your `settings.json` file.
|
|
|
1010
1010
|
- **Default:** `false`
|
|
1011
1011
|
|
|
1012
1012
|
- **`experimental.plan`** (boolean):
|
|
1013
|
-
- **Description:** Enable
|
|
1014
|
-
- **Default:** `
|
|
1013
|
+
- **Description:** Enable Plan Mode.
|
|
1014
|
+
- **Default:** `true`
|
|
1015
1015
|
- **Requires restart:** Yes
|
|
1016
1016
|
|
|
1017
1017
|
- **`experimental.modelSteering`** (boolean):
|
package/bundle/gemini.js
CHANGED
|
@@ -196358,8 +196358,8 @@ var GIT_COMMIT_INFO, CLI_VERSION;
|
|
|
196358
196358
|
var init_git_commit = __esm({
|
|
196359
196359
|
"packages/core/dist/src/generated/git-commit.js"() {
|
|
196360
196360
|
"use strict";
|
|
196361
|
-
GIT_COMMIT_INFO = "
|
|
196362
|
-
CLI_VERSION = "0.33.0-preview.
|
|
196361
|
+
GIT_COMMIT_INFO = "0af0fb6a5";
|
|
196362
|
+
CLI_VERSION = "0.33.0-preview.11";
|
|
196363
196363
|
}
|
|
196364
196364
|
});
|
|
196365
196365
|
|
|
@@ -292827,7 +292827,7 @@ function getVersion() {
|
|
|
292827
292827
|
}
|
|
292828
292828
|
versionPromise = (async () => {
|
|
292829
292829
|
const pkgJson = await getPackageJson(__dirname3);
|
|
292830
|
-
return "0.33.0-preview.
|
|
292830
|
+
return "0.33.0-preview.11";
|
|
292831
292831
|
})();
|
|
292832
292832
|
return versionPromise;
|
|
292833
292833
|
}
|
|
@@ -433551,7 +433551,7 @@ var init_config4 = __esm({
|
|
|
433551
433551
|
this.enableAgents = params.enableAgents ?? false;
|
|
433552
433552
|
this.agents = params.agents ?? {};
|
|
433553
433553
|
this.disableLLMCorrection = params.disableLLMCorrection ?? true;
|
|
433554
|
-
this.planEnabled = params.plan ??
|
|
433554
|
+
this.planEnabled = params.plan ?? true;
|
|
433555
433555
|
this.planModeRoutingEnabled = params.planSettings?.modelRouting ?? true;
|
|
433556
433556
|
this.enableEventDrivenScheduler = params.enableEventDrivenScheduler ?? true;
|
|
433557
433557
|
this.skillsSupport = params.skillsSupport ?? true;
|
|
@@ -483982,8 +483982,8 @@ var SETTINGS_SCHEMA = {
|
|
|
483982
483982
|
label: "Plan",
|
|
483983
483983
|
category: "Experimental",
|
|
483984
483984
|
requiresRestart: true,
|
|
483985
|
-
default:
|
|
483986
|
-
description: "Enable
|
|
483985
|
+
default: true,
|
|
483986
|
+
description: "Enable Plan Mode.",
|
|
483987
483987
|
showInDialog: true
|
|
483988
483988
|
},
|
|
483989
483989
|
modelSteering: {
|
|
@@ -515099,7 +515099,7 @@ var WarningMessage = ({ text }) => {
|
|
|
515099
515099
|
};
|
|
515100
515100
|
|
|
515101
515101
|
// packages/cli/src/generated/git-commit.ts
|
|
515102
|
-
var GIT_COMMIT_INFO2 = "
|
|
515102
|
+
var GIT_COMMIT_INFO2 = "0db01a9d7";
|
|
515103
515103
|
|
|
515104
515104
|
// packages/cli/src/ui/components/AboutBox.tsx
|
|
515105
515105
|
init_dist8();
|
|
@@ -563510,7 +563510,7 @@ async function loadSandboxConfig(settings, argv) {
|
|
|
563510
563510
|
const sandboxOption = argv.sandbox ?? settings.tools?.sandbox;
|
|
563511
563511
|
const command2 = getSandboxCommand(sandboxOption);
|
|
563512
563512
|
const packageJson2 = await getPackageJson(__dirname13);
|
|
563513
|
-
const image2 = process.env["GEMINI_SANDBOX_IMAGE"] ?? "us-docker.pkg.dev/gemini-code-dev/gemini-cli/sandbox:0.33.0-preview.
|
|
563513
|
+
const image2 = process.env["GEMINI_SANDBOX_IMAGE"] ?? "us-docker.pkg.dev/gemini-code-dev/gemini-cli/sandbox:0.33.0-preview.11" ?? packageJson2?.config?.sandboxImageUri;
|
|
563514
563514
|
return command2 && image2 ? { command: command2, image: image2 } : void 0;
|
|
563515
563515
|
}
|
|
563516
563516
|
|