From 782ef02e6e33988cbbbc3dc003009b0461fa3ce6 Mon Sep 17 00:00:00 2001
From: Emma Youndtsmith <90283317+emma-squared@users.noreply.github.com>
Date: Tue, 3 Feb 2026 14:39:06 -0600
Subject: [PATCH] Document keyboard shortcut menu (#6928)
Co-authored-by: dianed-square <73617011+dianed-square@users.noreply.github.com>
---
.../docs/guides/sessions/session-management.md | 14 +++++++++++++-
1 file changed, 13 insertions(+), 1 deletion(-)
diff --git a/documentation/docs/guides/sessions/session-management.md b/documentation/docs/guides/sessions/session-management.md
index bb49fe88..11afad69 100644
--- a/documentation/docs/guides/sessions/session-management.md
+++ b/documentation/docs/guides/sessions/session-management.md
@@ -53,7 +53,15 @@ In your first session, goose prompts you to [set up an LLM (Large Language Model
| Focus goose Window | `Cmd+Option+G` | `Ctrl+Alt+G` |
| Keep goose Window Always on Top | `Cmd+Shift+T` | `Ctrl+Shift+T` |
-
+ #### Customize Keyboard Shortcuts
+
+ You can customize these keyboard shortcuts in the **Settings** menu:
+ 1. Click the button in the top-left to open the sidebar
+ 2. Click `Settings`
+ 3. Click the `Keyboard` tab
+
+ Changes to global shortcuts (Focus Window, Quick Launcher) take effect immediately. Changes to application shortcuts (New Chat, Settings, etc.) require restarting goose.
+
#### Quick Launcher
Start a new session by typing your prompt into a popup:
1. Press `Cmd+Option+Shift+G` (macOS) or `Ctrl+Alt+Shift+G` (Windows/Linux) to open the popup
@@ -143,6 +151,10 @@ Search allows you to find specific content within sessions or find specific sess
| Toggle Case-Sensitivity | `Aa` | `Aa` |
| Close Search | `Esc` or `X` | `Esc` or `X` |
+ :::tip Customize Search Shortcuts
+ You can [customize](#keyboard-shortcuts) the Find, Find Next, and Find Previous keyboard shortcuts in **Settings** → **Keyboard** tab.
+ :::
+
:::info No Regex or operator support
Using regular expressions or search operators in search text isn't supported.
:::