From df52b77c886d4434a73ea41212f98045c5755120 Mon Sep 17 00:00:00 2001 From: "A.K.M. Adib" Date: Thu, 26 Feb 2026 11:16:27 -0500 Subject: [PATCH 1/5] complete --- docs/cli/plan-mode.md | 14 ++++++++------ docs/reference/keyboard-shortcuts.md | 12 ++++++------ 2 files changed, 14 insertions(+), 12 deletions(-) diff --git a/docs/cli/plan-mode.md b/docs/cli/plan-mode.md index 654b54dbc97..e3b45465138 100644 --- a/docs/cli/plan-mode.md +++ b/docs/cli/plan-mode.md @@ -89,12 +89,14 @@ manually during a session. 3. **Draft:** Once an approach is selected, write a detailed implementation plan to the plans directory. 4. **Review & Approval:** Use the [`exit_plan_mode`] tool to present the plan - and formally request approval. - - **Approve:** Exit Plan Mode and start implementation. - - **Iterate:** Provide feedback to refine the plan. - -For more complex or specialized planning tasks, you can -[customize the planning workflow with skills](#customizing-planning-with-skills). + and formally request approval. - **Approve:** Exit Plan Mode and start + implementation. - **Iterate:** Provide feedback to refine the plan. - + **Refine manually:** Press **Ctrl + X** to open the plan file in your + [preferred external editor](../reference/configuration.md#general). This + allows you to manually refine the plan steps before approval. The CLI will + automatically refresh and show the updated plan after you save and close the + editor. For more complex or specialized planning tasks, you can + [customize the planning workflow with skills](#customizing-planning-with-skills). ### Exiting Plan Mode diff --git a/docs/reference/keyboard-shortcuts.md b/docs/reference/keyboard-shortcuts.md index 1402422c6be..017531615f2 100644 --- a/docs/reference/keyboard-shortcuts.md +++ b/docs/reference/keyboard-shortcuts.md @@ -87,12 +87,12 @@ available combinations. #### Text Input -| Action | Keys | -| ---------------------------------------------- | ----------------------------------------------------------------------------------------- | -| Submit the current prompt. | `Enter (no Shift, Alt, Ctrl, Cmd)` | -| Insert a newline without submitting. | `Ctrl + Enter`
`Cmd + Enter`
`Alt + Enter`
`Shift + Enter`
`Ctrl + J` | -| Open the current prompt in an external editor. | `Ctrl + X` | -| Paste from the clipboard. | `Ctrl + V`
`Cmd + V`
`Alt + V` | +| Action | Keys | +| ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | +| Submit the current prompt. | `Enter (no Shift, Alt, Ctrl, Cmd)` | +| Insert a newline without submitting. | `Ctrl + Enter`
`Cmd + Enter`
`Alt + Enter`
`Shift + Enter`
`Ctrl + J` | +| Open the current prompt (or the plan file during Plan Mode approval) in an external editor. | `Ctrl + X` | +| Paste from the clipboard. | `Ctrl + V`
`Cmd + V`
`Alt + V` | #### App Controls From fca028a525403d7433df6aab86ad1ad65deecf4b Mon Sep 17 00:00:00 2001 From: "A.K.M. Adib" Date: Thu, 26 Feb 2026 11:20:31 -0500 Subject: [PATCH 2/5] update formatting --- docs/cli/plan-mode.md | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/docs/cli/plan-mode.md b/docs/cli/plan-mode.md index e3b45465138..4b519d24f82 100644 --- a/docs/cli/plan-mode.md +++ b/docs/cli/plan-mode.md @@ -89,14 +89,17 @@ manually during a session. 3. **Draft:** Once an approach is selected, write a detailed implementation plan to the plans directory. 4. **Review & Approval:** Use the [`exit_plan_mode`] tool to present the plan - and formally request approval. - **Approve:** Exit Plan Mode and start - implementation. - **Iterate:** Provide feedback to refine the plan. - - **Refine manually:** Press **Ctrl + X** to open the plan file in your - [preferred external editor](../reference/configuration.md#general). This - allows you to manually refine the plan steps before approval. The CLI will - automatically refresh and show the updated plan after you save and close the - editor. For more complex or specialized planning tasks, you can - [customize the planning workflow with skills](#customizing-planning-with-skills). + and formally request approval. + - **Approve:** Exit Plan Mode and start implementation. + - **Iterate:** Provide feedback to refine the plan. + - **Refine manually:** Press **Ctrl + X** to open the plan file in your + [preferred external editor](../reference/configuration.md#general). This + allows you to manually refine the plan steps before approval. The CLI will + automatically refresh and show the updated plan after you save and close + the editor. + +For more complex or specialized planning tasks, you can +[customize the planning workflow with skills](#customizing-planning-with-skills). ### Exiting Plan Mode From ca65744d1418e1b80cee28cb9bffc1e89ac635d8 Mon Sep 17 00:00:00 2001 From: "A.K.M. Adib" Date: Thu, 26 Feb 2026 12:21:51 -0500 Subject: [PATCH 3/5] address feedback --- docs/cli/plan-mode.md | 8 ++++---- packages/cli/src/config/keyBindings.ts | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/cli/plan-mode.md b/docs/cli/plan-mode.md index 4b519d24f82..bdbf56225e0 100644 --- a/docs/cli/plan-mode.md +++ b/docs/cli/plan-mode.md @@ -93,10 +93,9 @@ manually during a session. - **Approve:** Exit Plan Mode and start implementation. - **Iterate:** Provide feedback to refine the plan. - **Refine manually:** Press **Ctrl + X** to open the plan file in your - [preferred external editor](../reference/configuration.md#general). This - allows you to manually refine the plan steps before approval. The CLI will - automatically refresh and show the updated plan after you save and close - the editor. + [preferred external editor]. This allows you to manually refine the plan + steps before approval. The CLI will automatically refresh and show the + updated plan after you save and close the editor. For more complex or specialized planning tasks, you can [customize the planning workflow with skills](#customizing-planning-with-skills). @@ -295,3 +294,4 @@ performance. You can disable this automatic switching in your settings: https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/policy/policies/plan.toml [auto model]: /docs/reference/configuration.md#model-settings [model routing]: /docs/cli/telemetry.md#model-routing +[preferred external editor]: /docs/reference/configuration.md#general diff --git a/packages/cli/src/config/keyBindings.ts b/packages/cli/src/config/keyBindings.ts index 4813abd3680..9890798398d 100644 --- a/packages/cli/src/config/keyBindings.ts +++ b/packages/cli/src/config/keyBindings.ts @@ -489,7 +489,7 @@ export const commandDescriptions: Readonly> = { [Command.SUBMIT]: 'Submit the current prompt.', [Command.NEWLINE]: 'Insert a newline without submitting.', [Command.OPEN_EXTERNAL_EDITOR]: - 'Open the current prompt in an external editor.', + 'Open the current prompt (or the plan file during Plan Mode approval) in an external editor.', [Command.PASTE_CLIPBOARD]: 'Paste from the clipboard.', // App Controls From 90a5e6247c723fbe4d330950933718064c4075be Mon Sep 17 00:00:00 2001 From: Adib234 <30782825+Adib234@users.noreply.github.com> Date: Thu, 26 Feb 2026 12:56:44 -0500 Subject: [PATCH 4/5] Update packages/cli/src/config/keyBindings.ts Co-authored-by: Jerop Kipruto --- packages/cli/src/config/keyBindings.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/cli/src/config/keyBindings.ts b/packages/cli/src/config/keyBindings.ts index 9890798398d..3122acef1d9 100644 --- a/packages/cli/src/config/keyBindings.ts +++ b/packages/cli/src/config/keyBindings.ts @@ -489,7 +489,7 @@ export const commandDescriptions: Readonly> = { [Command.SUBMIT]: 'Submit the current prompt.', [Command.NEWLINE]: 'Insert a newline without submitting.', [Command.OPEN_EXTERNAL_EDITOR]: - 'Open the current prompt (or the plan file during Plan Mode approval) in an external editor.', + 'Open the current prompt or the plan in an external editor.', [Command.PASTE_CLIPBOARD]: 'Paste from the clipboard.', // App Controls From 4afd892f9543751ea705e2cd97cbb9c39dcc8f9e Mon Sep 17 00:00:00 2001 From: "A.K.M. Adib" Date: Thu, 26 Feb 2026 13:44:07 -0500 Subject: [PATCH 5/5] update docs --- docs/reference/keyboard-shortcuts.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/reference/keyboard-shortcuts.md b/docs/reference/keyboard-shortcuts.md index 017531615f2..4fc28804f70 100644 --- a/docs/reference/keyboard-shortcuts.md +++ b/docs/reference/keyboard-shortcuts.md @@ -87,12 +87,12 @@ available combinations. #### Text Input -| Action | Keys | -| ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | -| Submit the current prompt. | `Enter (no Shift, Alt, Ctrl, Cmd)` | -| Insert a newline without submitting. | `Ctrl + Enter`
`Cmd + Enter`
`Alt + Enter`
`Shift + Enter`
`Ctrl + J` | -| Open the current prompt (or the plan file during Plan Mode approval) in an external editor. | `Ctrl + X` | -| Paste from the clipboard. | `Ctrl + V`
`Cmd + V`
`Alt + V` | +| Action | Keys | +| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------- | +| Submit the current prompt. | `Enter (no Shift, Alt, Ctrl, Cmd)` | +| Insert a newline without submitting. | `Ctrl + Enter`
`Cmd + Enter`
`Alt + Enter`
`Shift + Enter`
`Ctrl + J` | +| Open the current prompt or the plan in an external editor. | `Ctrl + X` | +| Paste from the clipboard. | `Ctrl + V`
`Cmd + V`
`Alt + V` | #### App Controls