Keyboard shortcuts
One command registry drives the menus, the command palette, the keyboard shortcuts, the Settings › Shortcuts page and the command operation of the UI control channel.
On Windows and Linux, Cmd is shown and typed as Ctrl. The one exception is full screen: Ctrl+Cmd+F on macOS, F11 elsewhere.
Settings › Shortcuts lists them read-only. Postguy does not check shortcuts for conflicts.Command palette
Press Cmd/Ctrl+K (when no text field has focus) or click the search button in the header.
- Type to filter. The match is fuzzy and not case-sensitive, so letters only have to appear in order.
- With no prefix, the list shows matching workspace items first, then commands. Workspace items are open tabs, up to 10 recently closed tabs, collections, folders, requests and environments.
- Start the query with
>to list commands only. - At most 12 results are shown.
UpandDownmove.Enterruns the selected row.Esccloses the palette.- A command row's hint reads
Group · shortcut.
Commands
Commands with no shortcut are still in the palette. If a command has a menu entry, it is in the menu bar too.
Create
| Command | macOS | Windows / Linux |
|---|---|---|
| New HTTP request | Cmd+N | Ctrl+N |
| New collection | none | none |
| New environment | none | none |
| Import… | Cmd+I | Ctrl+I |
| Export all workspace data… | none | none |
Request
| Command | macOS | Windows / Linux |
|---|---|---|
| Send request | Cmd+Enter | Ctrl+Enter |
| Cancel request | Esc | Esc |
Esc for Cancel request, but no key handler for it exists in the code. Use the Cancel button that replaces Send while a request runs, or the palette.Tabs
| Command | macOS | Windows / Linux |
|---|---|---|
| Close tab | Cmd+W | Ctrl+W |
| Reopen closed tab | Cmd+Shift+T | Ctrl+Shift+T |
| Next tab | Cmd+Tab | Ctrl+Tab |
| Previous tab | Cmd+Shift+Tab | Ctrl+Shift+Tab |
View
| Command | macOS | Windows / Linux |
|---|---|---|
| Toggle sidebar | Cmd+\ | Ctrl+\ |
| Toggle console | Cmd+Alt+C | Ctrl+Alt+C |
| Toggle code snippet panel | none | none |
| Toggle two-pane layout | Cmd+Alt+V | Ctrl+Alt+V |
| Clear console | none | none |
| Zoom in | Cmd+= (Cmd+Shift++ also works) | Ctrl+= (Ctrl+Shift++ also works) |
| Zoom out | Cmd+- | Ctrl+- |
| Reset zoom | Cmd+0 | Ctrl+0 |
| Toggle full screen | Ctrl+Cmd+F | F11 |
Go
| Command | macOS | Windows / Linux |
|---|---|---|
| Open settings | Cmd+, | Ctrl+, |
| Open globals | none | none |
| Open cookies | none | none |
| Open collection runner | none | none |
| Open trash | none | none |
Edit
| Command | macOS | Windows / Linux |
|---|---|---|
| Undo | Cmd+Z | Ctrl+Z |
| Redo | Cmd+Shift+Z | Ctrl+Shift+Z |
| Cut | Cmd+X | Ctrl+X |
| Copy | Cmd+C | Ctrl+C |
| Paste | Cmd+V | Ctrl+V |
| Delete | none | none |
Window
| Command | macOS | Windows / Linux |
|---|---|---|
| Minimize | Cmd+M | Ctrl+M |
| Close window | Cmd+Shift+W | Ctrl+Shift+W |
| Quit Postguy | Cmd+Q | Ctrl+Q |
| Zoom, Fill, Center | none | none |
| Left half, Right half, Top half, Bottom half | none | none |
| Top left, Top right, Bottom left, Bottom right | none | none |
| Left third, Center third, Right third | none | none |
| Left two-thirds, Right two-thirds | none | none |
| Return to previous size | none | none |
Help
| Command | macOS | Windows / Linux |
|---|---|---|
| Documentation | none | none |
| GitHub | none | none |
The registry holds 53 commands in total. Documentation and GitHub open a page in your browser, and only when you choose them.
When a shortcut works
Registry shortcuts are ignored while a text field has keyboard focus. These always fire:
- The zoom commands.
- Full screen.
- Every
Windowcommand (Minimize,Close window, placement). Quit.
The text field itself handles the Edit shortcuts.
Shortcuts outside the registry
| Keys | Where | Action |
|---|---|---|
Cmd/Ctrl+S | Request builder | Save the request. |
Cmd/Ctrl+Enter | Request builder | Send the request. |
Cmd/Ctrl+Z, Cmd/Ctrl+Shift+Z | Anywhere without a focused text field | Undo or redo the last rename or move in the sidebar tree. |
Cmd/Ctrl+D | Code editors | Add the next occurrence of the selection as another cursor. |
Cmd/Ctrl+A | Code editors | Select all. |
Up, Down | Sidebar | Move the focused row. |
Right, Left | Sidebar | Expand or collapse a folder, collection, or a request's examples. |
Enter | Sidebar | Open the focused row. |
F2 | Sidebar | Rename the focused row. |
Cmd/Ctrl+C, Cmd/Ctrl+X, Cmd/Ctrl+V | Sidebar | Copy, cut, paste items. A paste on a collection or folder pastes inside it; on a request, into its collection. |
Delete | Sidebar | Delete the focused item. On a History row it removes that history entry. |
Cmd/Ctrl-click, Shift-click | Sidebar | Multi-select. |
| Middle-click a tab | Tab strip | Close the tab. |
| Drag a tab | Tab strip | Reorder tabs. |
Esc | Palette, dialogs, inline rename | Close or cancel. |
Sidebar keys work only when a sidebar row is focused and no text field has focus. See Collections for what copy, cut, paste and delete do.
Run a command from outside the window
You can run any command id (for example request.send, view.sidebar, runner.open) through the control channel:
postguy-cli ui --control FILE command ID
See UI control channel.