Docs › Shortcuts
Shortcuts
On the Mac, shortcuts use ⌘. On Windows and Linux, ⌘ becomes Ctrl+Shift, and whatever would collide with the terminal goes on the Leader key (Ctrl+Shift+Space). The Mac / Windows-Linux switch shows your system's keys.
Shortcuts that work anywhere in the app. The ones that only exist on Windows and Linux have an empty Mac side.
| New terminal | ⌘TCtrl+Shift+T |
| Open on a server | ⌘KCtrl+Shift+K |
| New note | ⇧⌘DLeader D |
| New workspace | ⇧⌘NCtrl+Shift+N |
| Delete the selection (canvas) or close the tab (Tabs) | ⌘WCtrl+Shift+W |
| Show or hide the sidebar | ⌘SCtrl+Shift+S |
| Settings | ⌘,Ctrl+, |
| Undo | ⌘ZCtrl+Z |
| Redo | ⇧⌘ZCtrl+Shift+Z or Ctrl+Y |
| Copy | ⌘CCtrl+Shift+C or Ctrl+Insert (on the canvas, Ctrl+C) |
| Paste | ⌘VCtrl+Shift+V or Shift+Insert (on the canvas and on Windows, Ctrl+V) |
| Select all | ⌘ACtrl+Shift+A |
| Search for an action (action palette) | —Ctrl+Shift+P |
| Full screen | —F11 |
| Quit | ⌘QCtrl+Shift+Q |
On Windows and Linux, Ctrl with a letter belongs to the terminal (Ctrl+C interrupts, Ctrl+D exits). The exceptions: on Windows, Ctrl+V pastes and Ctrl+C with text selected copies; on the canvas, Ctrl+C, Ctrl+V, Ctrl+Z and Ctrl+Y belong to the app. That's why the app's shortcuts use Ctrl+Shift or the Leader key. On the Mac, full screen is the window's green button.
See alsoThe Leader key (Windows and Linux)Windows and Linux only
Tool letters only work with nothing selected on the canvas, so they don't steal what you type in a card. They're the same on Mac, Windows and Linux.
| Select | V |
| Hand (move the view) | H |
| Hand while held | Hold Space |
| Terminal | T |
| Note | N |
| Text | L |
| File tree | F |
| Portal | P |
| Draw | X |
| Rectangle | B or R |
| Diamond | D |
| Ellipse | O |
| Arrow | A |
| Cloud accounts | ⇧⌘ULeader U |
| Back to the pointer or clear the selection | Esc |
See alsoToolbarShapes and text
Zoom, framing and the canvas's two reading modes.
| Show all | ⌘0Ctrl+0 |
| Zoom in | ⌘=Ctrl+= |
| Zoom out | ⌘-Ctrl+- |
| Actual size (100%) | ⌥⌘0Leader 0 |
| Focus on the selected item | ⌘\Leader E |
| Zoom to selection | ⌥⌘\Leader Z |
| Standard mode | ⌃⌘↩Leader ↩ |
| Standard mode from anywhere on the card | ⌘ + double-clickCtrl + double-click |
| Focus mode | ⇧⌘↩Ctrl+Shift+↩ |
| Exit focus mode | Esc |
| Switch between chat and terminal | ⌘JCtrl+Shift+J |
Link, group, gather into folders, duplicate and arrange cards.
| Start connection (link to another card) | ⌘LCtrl+Shift+L |
| Group | ⌘GCtrl+Shift+G |
| Ungroup | ⇧⌘GLeader G |
| Gather into folder / Spread out | ⌥⌘GLeader P |
| Duplicate terminal | ⌘DCtrl+Shift+D |
| Arrange (again: for reading) | ⇧⌘TLeader T |
| Arrange for reading | ⌥⇧⌘TLeader R |
| Delete the selection | ⌫Delete or Backspace |
| Copy cards | ⌘CCtrl+C |
| Paste cards | ⌘VCtrl+V |
See alsoTentacles (cables)GroupsFoldersArrange and Arrange for reading
Now, history, saved groups, cloud accounts and Open on a server open and close with the same shortcut. On the Mac, “All sessions” closes with Esc. ⇧⌘JLeader J takes you to the next card that needs you.
| Now | ⇧⌘OCtrl+Shift+O |
| Next one needing you | ⇧⌘JLeader J |
| Workspace history | ⌘YCtrl+Shift+Y |
| Workspace saved groups | ⇧⌘YLeader Y |
| All sessions | ⇧⌘HCtrl+Shift+H |
| Cloud accounts | ⇧⌘ULeader U |
| Open on a server | ⌘KCtrl+Shift+K |
See alsoThe sidebar
Shortcuts for terminal cards. They act on the terminal that has the keyboard (or the selected one).
| Find | ⌘FCtrl+Shift+F |
| Clear (screen and tmux history) | ⇧⌘KLeader K |
| Larger font (all terminals) | ⇧⌘+Leader = |
| Smaller font (all terminals) | ⇧⌘-Leader - |
| Folder file tree | ⇧⌘ECtrl+Shift+E |
| Shell beside | ⌥⌘TLeader S |
| Switch between chat and terminal | ⌘JCtrl+Shift+J |
| Duplicate terminal | ⌘DCtrl+Shift+D |
| Copy | ⌘CCtrl+Shift+C or Ctrl+Insert |
| Paste (a copied image or files become paths) | ⌘VCtrl+Shift+V or Shift+Insert (Ctrl+V on Windows) |
| Select all | ⌘ACtrl+Shift+A |
| Open a link | ⌘ + clickCtrl + click |
| Open a file path | —Ctrl + click |
On Linux, the middle mouse button also pastes, as in other Linux terminals. Ctrl+V stays with the terminal on Linux, for vim, the shell and Claude Code's image pasting.
In Tabs mode, the canvas keys act on tabs and on the panes of a split.
| Tab 1 to 9 | ⌘1–9Ctrl+1–9 |
| Next tab | ⌃TabCtrl+Tab |
| Previous tab | ⌃⇧TabCtrl+Shift+Tab |
| Group 1 to 9 | ⌃⌘1–9Alt+1–9 |
| Close tab (in a split, the pane that has the keyboard) | ⌘WCtrl+Shift+W |
| Neighboring pane | ⌃⌘ + arrowsLeader + arrows |
| New terminal as a tab | ⌘TCtrl+Shift+T |
| New note as a tab | ⇧⌘DLeader D |
On Windows and Linux, Leader + arrow in Tabs doesn't turn on navigation mode: the arrows that follow go to the terminal.
See alsoTabs keys
Keys that work inside a panel or an open card.
| Open on a server: open a Shell | ↩ |
| Open on a server: open Claude Code | ⌘↩Ctrl+↩ |
| Open on a server: open Codex | ⌥↩Alt+↩ |
| Open on a server: choose the folder | ⇥Tab |
| Open on a server: move through the list and close | ↑ ↓ and esc↑ ↓ and Esc |
| Now: open card 1 to 9 | 1–9 |
| Now: move and open | ↑ ↓ and ↩ |
| Now: close | Esc |
| Cloud accounts: put account 1 to 9 on the canvas | 1–9 |
| Chat: send | ↩ |
| Chat: new line | Shift+↩ |
| Chat: send now, interrupting the agent | ⌘↩Ctrl+↩ |
| Chat: stop the agent or deny a permission | Esc |
| Chat: answer a permission or a question | 1–9 |
| Chat: agent commands and mentioning a file | / and @ |
| Voice: cancel | escEsc |
| Voice: pause and continue | Space |
| Voice: insert as is | ↩ |
| Voice: clean up the text | ⇥Tab |
| Tree: copy and paste items | ⌘C and ⌘VCtrl+C (or Ctrl+Insert) and Ctrl+V |
| Tree: duplicate | ⌘DCtrl+D |
| Tree: select all items | —Ctrl+A |
| Tree: copy the path | ⌥⌘CCtrl+Shift+C |
| Tree: rename | ↩ |
| Tree: move to Trash | ⌘⌫Delete |
| Tree and file cards: Quick Look | Space |
| Open file: find | ⌘FCtrl+F |
| Open file: next and previous result | ↩ and ⇧↩↩ and Shift+↩ |
| Open file: previous and next change in the diff | ⌥↑ and ⌥↓Alt+↑ and Alt+↓ |
| Open file: send the question about the selection | ⌘↩Ctrl+↩ |
| Commit and Push | ⌘↩Ctrl+↩ |
| Folder browser: parent folder | ⌘↑Alt+↑ |
See alsoOpen on a server…Permissions: 1–9 and EscKeys while you speakOpen a file tree
Canvas gestures with the mouse and the trackpad (on Windows and Linux, the touchpad).
| Add one more to the selection | Shift+click |
| Select with a rectangle | drag on empty space |
| Standard mode | double-click the header or footer |
| Pan the canvas | Hold Space, middle button or two fingers |
| Zoom | pinch |
| Zoom with two fingers on the trackpad | ⌘ or ⌥ + two fingersAlt + two fingers |
| Wheel: the opposite of the setting in Settings › General | ⌘ or ⌥ + wheelAlt + wheel (in pan mode, Ctrl or Alt) |
| Scroll sideways | Shift+wheel |
| Magnet while dragging | ⌘ + dragCtrl + drag |
| Duplicate by dragging | ⌥ + dragAlt + drag |
| Align the edge while resizing | ⌘ + drag the edgeCtrl + drag the edge |
| Square, circle or line in 15° steps | Shift while drawing |
| Quick Look for files and trees | quick tap on Space |
On Windows and Linux, Ctrl with a letter belongs to the terminal, and Ctrl+Alt is AltGr on many keyboards (like ABNT2). That's why shortcuts that would collide sit on a Leader key: Ctrl+Shift+Space, released, and then a key.
Step by step
- Press Ctrl+Shift+Space and release. A hint shows up on screen with the most used keys: D note, ↩ Standard mode, J Needs you (when someone is waiting), 0 100%, 1–9 workspace and Esc.
- Within 1.5 seconds, press the command's key. The key never goes to the terminal, even if it isn't a shortcut.
- After Leader + arrow, you're in navigation mode: the arrows alone keep moving to the neighboring card, and . and , follow and go back along the cables, until Esc or ↩. Any other key leaves the mode and does what it normally does.
- In Tabs, Leader + arrow goes to the neighboring pane without turning on navigation mode.
| Leader | —Ctrl+Shift+Space |
| New note | ⇧⌘DLeader D |
| Shell beside | ⌥⌘TLeader S |
| Ungroup | ⇧⌘GLeader G |
| Gather into folder / Spread out | ⌥⌘GLeader P |
| Next one needing you | ⇧⌘JLeader J |
| Workspace saved groups | ⇧⌘YLeader Y |
| Cloud accounts | ⇧⌘ULeader U |
| Arrange (again: for reading) | ⇧⌘TLeader T |
| Arrange for reading | ⌥⇧⌘TLeader R |
| Focus on the item | ⌘\Leader E |
| Zoom to selection | ⌥⌘\Leader Z |
| Clear the terminal | ⇧⌘KLeader K |
| Larger / smaller font | ⇧⌘+ / ⇧⌘-Leader = / Leader - |
| Actual size (100%) | ⌥⌘0Leader 0 |
| Standard mode | ⌃⌘↩Leader ↩ |
| Workspace 1 to 9 | ⌘ twice + 1–9Leader 1–9 |
| Go to the card next to it | ⌃⌘ + arrowsLeader + arrows |
| Follow / go back along the connection | ⌥⌘→ / ⌥⌘←Leader . / Leader , |
| Cancel the Leader | —Esc |
Keys work by their position on the keyboard, not by the printed letter: on a different layout, use the key that sits where the US letter is. Octopus never uses Ctrl+Alt or the Windows key.
Without the Mac's menu bar, Windows and Linux have an action palette and a few extra shortcuts.
Step by step
- Press Ctrl+Shift+P and type part of an action's name (“Search for an action”). The palette has what the Mac menus have: “New portal”, “New Draw”, “New server…”, “New account”, “Set Up This Computer…”, “Check for Updates…”, “Align › …”, “Go to Card › …”, “Appearance: Light / Dark”, “Group: …”, “Go to workspace …” and the other commands, with the shortcut next to them when there is one.
- Right-clicking empty canvas gives you “Undo”, “Redo” and “Paste”. In text fields, there's “Cut”, “Copy”, “Paste” and “Select all”.
| Search for an action | —Ctrl+Shift+P |
| Full screen | —F11 |
| Quit Octopus | ⌘QCtrl+Shift+Q |
| Copy and paste in the terminal | ⌘C / ⌘VCtrl+Shift+C / Ctrl+Shift+V, or Ctrl+Insert / Shift+Insert |
| Paste with Ctrl+V | ⌘VCtrl+V (Windows only) |
| Paste with the middle button | —middle button (Linux only) |
| Open a link in the terminal | ⌘ + clickCtrl + click |
| Open a file path in the terminal | —Ctrl + click |
On the Mac, full screen is the window's green button.
See alsoThe action paletteRight-click menusThe Leader key (Windows and Linux)
On the Mac, the Canvas and Terminal menus in the menu bar list every command with its shortcut next to it.
Step by step
- Open the Canvas menu to see zoom, appearance, navigation, “Start connection”, “Duplicate Terminal”, arranging, history, saved groups, “Now”, cloud accounts, “All Sessions”, grouping, folders, blur, align, terminals 1 to 9 and switching workspaces.
- Open the Terminal menu to find, clear, change the font, open the folder's tree, open a shell beside and switch between chat and terminal.
- The Octopus menu has “About Octopus”, “Check for Updates…”, Settings and “Set Up This Mac…”.
See alsoGeneral