Keyboard shortcuts¶

On macOS, use Cmd where Ctrl is shown.

These are the default shortcuts. You can give most commands of the menus other keys, remove a shortcut or give a command without one a shortcut in Settings → Keyboard; the menus and the command palette always show the shortcut in effect. Cut, Copy, Paste, Previous Prompt, Next Prompt, the zoom keys, F12, Ctrl+Tab, Ctrl+Shift+Tab and the tab jump keys stay fixed.

General¶

The zoom keys (Ctrl or Alt with + / - / 0; Cmd on macOS) zoom the terminal only while a terminal tab is selected. In a snippet editor or file editor tab they reach the editor, and AltGr++ types its character there.

The tab jump keys work in every tab, also while a terminal or an editor has the focus, and a number with no tab at its position does nothing. On macOS they are Cmd with a digit, and Cmd+Shift with a digit works too, so a French (AZERTY) Mac can reach its digits (macOS keeps Cmd+Shift+3 to Cmd+Shift+5 for screenshots). On Windows and Linux they are exactly Ctrl with a digit: AltGr combinations (which arrive as Ctrl+Alt) and Ctrl+Shift+6 (the Cisco break sequence) still reach the terminal. A digit key that types + or - in your layout, such as the AZERTY 6 key, stays a zoom key instead. On Linux with a layout whose number row types other characters, the top-row digits may not jump; the numpad digits (with Num Lock on) do.

Ctrl+Tab and Ctrl+Shift+Tab follow the tab bar unless Ctrl+Tab switches tabs in the order they were last used is on in the Window settings. Then Ctrl+Tab goes back to the tab you used before the current one; keep Ctrl held and press Tab again to go further back, add Shift to step the other way, and release Ctrl at the tab you want. Only that tab counts as used. Any other key ends the step-through first and then acts on the tab you stopped at.

Reopen Closed Tab uses Ctrl+Alt+Shift+T because Ctrl+Shift+T toggles the command timestamps and Ctrl+Alt+T the session journal. On Windows, AltGr arrives as Ctrl+Alt, so on a layout where AltGr+Shift+T types a character (such as Þ on US-International) that combination reopens a closed tab instead, and the character is not typed.

Terminal¶

These keys work while a terminal pane has the focus. For how they behave with several panes, see Broadcast mode.

On Windows and Linux, Ctrl+1 to Ctrl+9 no longer reach the program in the terminal: korTTY's terminal never sent them as keys of their own, so no program loses a binding it could receive.

On Windows and Linux, Clear Buffer and Find have no key of their own, so Ctrl+L and Ctrl+F stay with the programs running in the terminal. Use right-click → Clear Buffer or Find in the terminal, Edit → Find… with the mouse, or reach both from the keyboard through the command palette: Ctrl+Shift+P, type clear or find, Enter. Ctrl+Shift+F stays Terminal-only Fullscreen and Ctrl+Shift+K still docks the file browser on the left. Ctrl+Shift+H switches keyword highlighting and does not reach the terminal, while plain Ctrl+H still reaches the shell as backspace.

The paste keys go through paste protection: a paste with line breaks, with control characters or of a large size can open a confirmation first. In that dialog Cancel is the default button, so Enter, Space and Esc drop the paste; click Paste, or press Tab to reach it and Space to press it. While a paste is sent line by line (Pause after each pasted line), the pane takes no other keys and Esc stops the paste.

Every other combination of Shift, Ctrl and Alt with the arrow keys, Home / End, Page Up / Page Down, Ins / Del and F1 to F11 is sent the way xterm sends it (F12 always toggles fullscreen, and in a tab with two or more panes Ctrl+Alt with an arrow key moves the focus to another pane instead, see Panes), for example Ctrl+Page Up as ESC [ 5 ; 5 ~ and Shift+F1 as ESC [ 1 ; 2 P. The arrow keys follow the program's cursor-key mode: mc and vim switch it on and then receive ESC O A, while a shell receives ESC [ A. Connections with a non-xterm terminal emulation (Wyse, TeleVideo, HP, SCO ANSI, IBM 3270/5250, PETSCII) keep sending fixed sequences without modifiers.

Panes¶

These keys split the active terminal tab, move the keyboard focus between its panes and zoom one of them; see Split operations.

The split key works in every terminal tab while the keyboard is in it. On Windows and Linux it no longer reaches the shell, which received it as Ctrl+O; Ctrl+O itself still does, so nano still saves with it.

The focus keys and the zoom key act only while a terminal tab with two or more panes is active and the keyboard is in that tab; with a single pane they reach the program in the terminal as before, Ctrl+Shift+Enter as Enter. At the edge of the tab the focus stays where it is. When several panes lie on that side, the focus goes to the one that lies beside the focused pane rather than only touching its corner, and among those to the nearest one. Moving the focus while a pane is zoomed shows all panes again. View → Panes has the same commands, Split Right and Split Down to choose the side of a split, Close Pane, Zoom Pane, and Next Pane and Previous Pane, which go through all panes of the tab and start over after the last one. The command palette runs every one of them by name, and its rows show the keys of the table above.

Command palette¶

These keys work while the command palette is open. Every other key stays in the palette and never reaches the terminal behind it.

View → Snippet Palette… opens the palette with only the snippets listed and has no shortcut by default, because Ctrl+Shift+J already opens the JobScheduler. Once you give it one in Settings → Keyboard, that key opens the snippet palette also while a terminal has the focus, and pressing it while the palette is open closes the palette like Esc. The snippet you choose runs in the focused pane of its terminal tab.

SFTP Manager¶

These keys work in the local and the remote list of an SFTP Manager tab; see Keys.

Snippet Manager¶

These keys work in the Snippet Manager (library and editor tabs); see Opening the Snippet Manager.

If the focus is on the Snippet Manager's own tab header in the main window (tab mode), Ctrl+S still saves the project, and Ctrl+W closes the Snippet Manager tab after asking about unsaved changes.

Snippet editor¶

These keys work inside the snippet editor's code field; see AI Code completions.

Diagram zoom window¶

These keys work in the zoom window of the Full code analysis flow diagram; see Full code analysis.

Terminal AI agent¶