Keyboard shortcuts

Glueprint is built to be driven from the keyboard. You can switch workspaces, tabs and panes, open every panel and dialog, talk to the agent, and ship a pull request without touching the mouse.

The three shortcuts to learn first

• Cmd+K (Ctrl+K on Windows and Linux) opens the command palette. Every action on this page is in it, with its shortcut beside it, including the ones that ship without a key.
• Cmd+/ (Ctrl+/) opens the shortcut sheet: a searchable list of every binding, including any you changed. ? opens it too when you are not typing.
• Cmd+1 to Cmd+9 switch workspaces in the order the sidebar shows them: pinned worktrees first, then each expanded project, host by host. Collapsed projects and hosts are skipped. Hold Cmd for a moment and the sidebar shows each row’s number.

Want it on paper? Download the printable cheat sheet (PDF): one page each for macOS, Windows and Linux, and the web portal.

How shortcuts decide where they apply

Most navigation shortcuts work wherever your cursor is, including the chat input, which is where it usually is. A few rules keep them out of the way:

• Text fields keep their keys. Shortcuts that are marked “Outside text fields” do nothing while you are typing, so Cmd+[ still outdents code in the editor.
• Terminals keep shell keys. On Windows and Linux, Ctrl+W, Ctrl+T, Ctrl+R and other control keys go to the shell when a terminal has focus. On macOS, Cmd shortcuts still work from a terminal. Cmd+K in a terminal clears it rather than opening the palette.
• The editor keeps its own keys. Inside a code editor, editor commands such as Cmd+D (add the next match to the selection) and Cmd+F (find in file) win over the Glueprint command on the same key. The one exception is the portal’s Debug keys: F8 and Shift+F8 start, continue and stop debugging even inside an editor, so use Alt+F8 there to move between the problems in a file.
• Dialogs come first. While a dialog or sheet is open, background shortcuts are paused. The key that opened a dialog closes it.
• Detached windows (a workspace or project popped out into its own window) run the tab, pane, panel, composer, chat and git shortcuts for their own workspace. View switching, settings and the sidebar belong to the main window.

Reference

The Web portal column lists the portal’s keys. Browsers reserve many Cmd/Ctrl shortcuts (new tab, close tab, address bar, reload), so the portal uses Alt in their place. Alt is Option on a Mac. On a Mac, an Option shortcut typed inside a text field stays as typing, because Option types accented letters and symbols there, so use it after moving focus out of the field, or use the command palette. “Palette only” means the command has no default key there; “Desktop only” means the portal has no equivalent surface. The Debug keys move in the portal because a browser reloads on F5 and goes full screen on F11; Debugger lists both sets.

Navigation

Action	macOS	Windows and Linux	Web portal	Works when
Go to workspace 1-8 (sidebar order)	Cmd+1-8	Ctrl+1-8	Alt+1-8	Everywhere
Go to Workspace (Last)	Cmd+9	Ctrl+9	Alt+9	Everywhere
Next Workspace	Cmd+Option+Down	Ctrl+Alt+Down	Alt+Shift+Down	Everywhere
Previous Workspace	Cmd+Option+Up	Ctrl+Alt+Up	Alt+Shift+Up	Everywhere
Jump to Workspace, Session or Tab	Cmd+E	Ctrl+E	Alt+J	Everywhere
Next Session Needing Attention	Cmd+Option+L	Ctrl+Alt+L	Alt+Shift+L	Everywhere
Go to Workspaces	Cmd+Ctrl+1	Ctrl+Shift+1	Alt+Shift+1	Everywhere
Go to Assistants	Cmd+Ctrl+2	Ctrl+Shift+2	Alt+Shift+2	Everywhere
Go to Tasks	Cmd+Ctrl+3	Ctrl+Shift+3	Alt+Shift+3	Everywhere
Go to Routines	Cmd+Ctrl+4	Ctrl+Shift+4	Alt+Shift+4	Everywhere
Show Sessions List	Cmd+Ctrl+5	Ctrl+Shift+5	Alt+Shift+5	Everywhere
Show Terminals List	Cmd+Ctrl+6	Ctrl+Shift+6	Alt+Shift+6	Everywhere
Browse Channels	Palette only	Palette only	Palette only	Everywhere
Go to GitHub	Palette only	Palette only	Palette only	Everywhere
GitHub: My Work	Palette only	Palette only	Palette only	Everywhere
GitHub: Pull Requests	Palette only	Palette only	Palette only	Everywhere
GitHub: Issues	Palette only	Palette only	Palette only	Everywhere
GitHub: Actions	Palette only	Palette only	Palette only	Everywhere
Go to Workspace Home	Cmd+0	Ctrl+0	Alt+0	Outside text fields
Navigate Back	Cmd+[	Ctrl+[	Alt+[	Outside text fields
Navigate Forward	Cmd+]	Ctrl+]	Alt+]	Outside text fields

Tabs & Panes

Action	macOS	Windows and Linux	Web portal	Works when
Go to tab 1-8 in the focused pane	Ctrl+1-8	Alt+1-8	Palette only	In a workspace
Go to Tab (Last)	Ctrl+9	Alt+9	Palette only	In a workspace
Next Tab	Cmd+Shift+] or Ctrl+Tab or Cmd+Option+Right	Ctrl+Shift+] or Ctrl+Tab or Ctrl+Alt+Right	Alt+Shift+]	In a workspace
Previous Tab	Cmd+Shift+[ or Ctrl+Shift+Tab or Cmd+Option+Left	Ctrl+Shift+[ or Ctrl+Shift+Tab or Ctrl+Alt+Left	Alt+Shift+[	In a workspace
Close Tab	Cmd+W	Ctrl+W	Alt+W	Everywhere
Reopen Closed Tab	Cmd+Shift+T	Ctrl+Shift+T	Alt+Shift+T	In a workspace
New Session Tab	Cmd+T	Ctrl+T	Alt+T	In a workspace
New Terminal Tab	Ctrl+Backtick	Ctrl+Backtick	Ctrl+Backtick	In a workspace
New Browser Tab	Cmd+Shift+B	Ctrl+Shift+B	Palette only	In a workspace
Split Pane Right	Cmd+D	Ctrl+D	Alt+Shift+D	In a workspace
Split Pane Down	Cmd+Shift+D	Ctrl+Shift+D	Palette only	In a workspace
Focus Next Pane	Cmd+Option+Shift+Right	Ctrl+Alt+Shift+Right	Palette only	In a workspace
Focus Previous Pane	Cmd+Option+Shift+Left	Ctrl+Alt+Shift+Left	Palette only	In a workspace
Move Tab to Next Pane	Palette only	Palette only	Palette only	In a workspace
Move Tab to Previous Pane	Palette only	Palette only	Palette only	In a workspace

Panels

Action	macOS	Windows and Linux	Web portal	Works when
Toggle Sidebar	Cmd+B	Ctrl+B	Alt+B	Outside text fields
Toggle Right Panel	Cmd+Option+B	Ctrl+Alt+B	Alt+Shift+B	In a workspace
Show Files	Cmd+Shift+E	Ctrl+Shift+E	Alt+Shift+E	In a workspace
Show Workspace Tasks	Palette only	Palette only	Palette only	In a workspace
Show Checks	Palette only	Palette only	Palette only	In a workspace
Toggle Run Dock	Cmd+J	Ctrl+J	Palette only	In a workspace
Open Run Menu	Palette only	Palette only	Cmd/Ctrl+Alt+R	In a workspace
Start / Stop Run	Cmd+R	Ctrl+R	Alt+R	In a workspace

Composer & Agent

Action	macOS	Windows and Linux	Web portal	Works when
Focus Chat Input	Cmd+L	Ctrl+L	Alt+L	Everywhere
Interrupt Agent	Cmd+Shift+Backspace	Ctrl+Shift+Backspace	Alt+Shift+Backspace	Everywhere
Cycle Permission Mode	Shift+Tab	Shift+Tab	Shift+Tab	In the chat input
Choose Agent and Model	Cmd+Option+M	Ctrl+Alt+M	Palette only	Everywhere
Find in Chat	Cmd+F	Ctrl+F	Alt+Shift+F	In a session chat
Find Next in Chat	Cmd+G	Ctrl+G	Alt+G	In a session chat
Find Previous in Chat	Cmd+Shift+G	Ctrl+Shift+G	Alt+Shift+G	In a session chat

Git & Workspace

Action	macOS	Windows and Linux	Web portal	Works when
Show Uncommitted Changes	Cmd+Option+U	Ctrl+Alt+U	Alt+Shift+U	In a workspace
Commit and Push	Cmd+Shift+Y	Ctrl+Shift+Y	Alt+Shift+Y	In a workspace
Create Pull Request	Cmd+Shift+P	Ctrl+Shift+P	Alt+Shift+P	In a workspace
Open Pull Request	Cmd+Shift+G	Ctrl+Shift+G	Alt+Shift+G	In a workspace
Reveal Workspace Folder	Cmd+O	Ctrl+O	Desktop only	In a workspace
Copy Workspace Path	Cmd+Shift+C	Ctrl+Shift+C	Alt+Shift+C	In a workspace
New Workspace	Cmd+Shift+N	Ctrl+Shift+N	Palette only	Everywhere
Pin / Unpin Workspace	Palette only	Palette only	Palette only	In a workspace
Workspace Info	Palette only	Palette only	Palette only	In a workspace
Delete Workspace…	Palette only	Palette only	Palette only	In a workspace

Workbench

Action	macOS	Windows and Linux	Web portal	Works when
Command Palette	Cmd+K or F1	Ctrl+K or F1	Cmd/Ctrl+Shift+P or F1	Everywhere
Quick Open / Quick Switcher	Cmd+P	Ctrl+P	Cmd/Ctrl+P	Everywhere except terminals
Show Keyboard Shortcuts	Cmd+/ or ?	Ctrl+/ or ?	Alt+/ or ?	Everywhere
Tour This Section	Palette only	Palette only	Palette only	Outside text fields
Show Guided Tours	Palette only	Palette only	Palette only	Outside text fields
Report a Bug	Palette only	Palette only	Palette only	Outside text fields
Request a Feature	Palette only	Palette only	Palette only	Outside text fields
Send Feedback	Palette only	Palette only	Palette only	Outside text fields
Toggle Settings	Cmd+,	Ctrl+,	Cmd/Ctrl+,	Everywhere
Edit Keyboard Shortcuts	Cmd+Option+/	Ctrl+Alt+/	Alt+Shift+K	Everywhere except terminals
New in Current Context	Cmd+N	Ctrl+N	Alt+N	Everywhere
Show Alerts	Cmd+Shift+A	Ctrl+Shift+A	Alt+Shift+A	Everywhere
Choose Host	Palette only	Palette only	Palette only	Outside text fields
Open Account Menu	Palette only	Palette only	Palette only	Outside text fields
Focus Next Region	F6	F6	Desktop only	Everywhere
Focus Previous Region	Shift+F6	Shift+F6	Desktop only	Everywhere

Editor

Action	macOS	Windows and Linux	Web portal	Works when
Go to Symbol in Workspace	Cmd+Shift+O	Ctrl+Shift+O	Desktop only	In an editor
Find in Files	Cmd+Shift+F	Ctrl+Shift+F	Cmd/Ctrl+Shift+F (in the editor)	In an editor
Cycle View Mode	Cmd+Shift+V	Ctrl+Shift+V	Cmd/Ctrl+Shift+V	In an editor
Changes: Next Change	F7	F7	F7	In an editor
Changes: Previous Change	Shift+F7	Shift+F7	Shift+F7	In an editor
Toggle Problems Panel	Palette only	Palette only	Desktop only	In an editor
Save	Cmd+S	Ctrl+S	Cmd/Ctrl+S (in the editor)	In an editor
Save All	Cmd+Option+S	Ctrl+Alt+S	Desktop only	In an editor

Debug

Action	macOS	Windows and Linux	Web portal	Works when
Debug: Start / Continue	F5	F5	F8	In an editor
Debug: Stop	Shift+F5	Shift+F5	Shift+F8	In an editor
Debug: Restart	Cmd+Shift+F5	Ctrl+Shift+F5	Cmd/Ctrl+Shift+F8	In an editor
Debug: Toggle Breakpoint	F9	F9	F9	In an editor
Debug: Step Over	F10	F10	F10	In an editor
Debug: Step In	F11	F11	Alt+F10	In an editor
Debug: Step Out	Shift+F11	Shift+F11	Alt+Shift+F10	In an editor
Debug: Show Debug View	Palette only	Palette only	Palette only	In a workspace

Changing a shortcut

Open Settings > Keyboard (or press Cmd+Option+/, Ctrl+Alt+/ on Windows and Linux) and choose Edit bindings.

• Rebind: click a binding and press the new keys. If another command already uses them, Glueprint names it and keeps your old binding until you resolve the conflict.
• Remove: click Remove to leave a command without a key. It stays in the command palette.
• Reset: click Reset on one row, or Reset all, to return to the defaults.

A key you assign yourself wins over a default on the same keys. The portal keeps its own bindings in the browser, and refuses keys the browser reserves.

Related topics

• Find and quick-open for the editor palettes.
• The session view for the composer and chat.
• Opening a terminal for terminal-specific keys.