Skip to main content
Version: 1.6.0

Keyboard Shortcuts

Full Keyboard Shortcuts pane showing the master switch and all four shortcut groups

Review and customize keyboard shortcuts for RepoPrompt actions, including workspace, Compose, preset, and agent commands.

Open Settings → General → Keyboard Shortcuts. Click a shortcut recorder and press the desired key combination to change that action's binding. Use its clear button to remove a binding. Bindings are stored per app; menu-bar shortcuts or other apps can conflict with them.

The tables below list the implementation defaults. Your current bindings can differ. On a Mac, Command is ⌘, Option is ⌥, Control is ⌃, and Shift is ⇧.

Enable keyboard shortcuts​

Enable keyboard shortcuts master switch and explanation that custom bindings remain saved

Turn off Enable keyboard shortcuts to stop these registered shortcuts from running while keeping your custom bindings saved. Advanced exposes the same master setting.

Although this pane calls them global hotkeys, action handlers still check the app and window context. Workspace and session actions need an appropriate focused RepoPrompt window; agent shortcuts need a real workspace.

Agent & layout​

Agent and layout shortcuts for new chat, session sidebar, Context Composer, and session search

ActionDefault
New Agent chatOption+Command+N
Toggle session sidebarOption+Command+B
Toggle Context ComposerCommand+P
Show Agent Session SwitcherCommand+K
Search all Agent sessionsShift+Command+K

New Agent chat follows the titlebar's New Session action. The session switcher navigates sessions in the focused window; searching all sessions includes active and recent sessions across windows.

Workspace & presets​

Workspace save actions and numbered preset shortcuts

ActionDefault
Save workspaceCommand+S
Save workspace and switch to system workspaceShift+Command+S
Save current preset, or create one if none existsOption+Command+S
Create new presetOption+Command+P
Switch to preset 1–9Option+Command+1–9

Preset numbers follow the workspace manager's preset order. Saving the current preset opens the creation flow if the workspace has no presets. See Manage Presets for preset configuration.

Agent session tabs​

Session tab creation, closing, navigation, parent navigation, and numbered tab shortcuts

ActionDefault
New Agent session tabCommand+T
Close active Agent session tabCommand+W
Next Agent session tabControl+Tab
Previous Agent session tabControl+Shift+Tab
Next parent Agent sessionOption+Command+]
Previous parent Agent sessionOption+Command+[
Focus Agent session tab 1–9Command+1–9

Numbered session shortcuts follow the Agent session sidebar order. Parent-session navigation cycles only root rows; child sessions stay grouped under their parent.

Display​

Increase and decrease font size shortcut recorders

Command+= increases text size and Command+- decreases it. These step through the same global text-size presets as Appearance.