Skip to content
OpenWaggle

Keyboard shortcuts

Default shortcuts for conversations, terminals, browser preview, and navigation.

This page lists the default keyboard shortcuts. To see or change them, open Settings > Shortcuts.

Settings > Shortcuts with the search field, Add binding, Reset defaults, and the Panels group listing each panel and its binding (open full size)

Default shortcuts

The names are the ones Settings > Shortcuts shows. Where says when the shortcut works: Anywhere, Outside a terminal (not while you type in a terminal), In a terminal, or In the browser preview (while it has focus).

CommandmacOSWindows and LinuxWhere
Command paletteCmd+KCtrl+KOutside a terminal
Go to fileCmd+PCtrl+POutside a terminal
New sessionCmd+N or Cmd+Shift+OCtrl+N or Ctrl+Shift+OOutside a terminal
Toggle sidebarCmd+BCtrl+BAnywhere
Toggle terminalCmd+JCtrl+JAnywhere
Toggle right panelCmd+Option+BCtrl+Alt+BAnywhere
Maximize right panelUnassignedUnassignedAnywhere
Close right panelCmd+WCtrl+WOutside a terminal
Toggle diffCmd+DCtrl+DOutside a terminal
Toggle session treeCmd+Shift+YCtrl+Shift+YOutside a terminal
Toggle previewCmd+Shift+JCtrl+Shift+JAnywhere
Go to pending requestCmd+Shift+ACtrl+Shift+AAnywhere
Copy session linkCmd+Option+LCtrl+Alt+LAnywhere
New terminalCmd+NCtrl+NIn a terminal
Split terminal side by sideCmd+DCtrl+DIn a terminal
Split terminal verticallyCmd+Shift+DCtrl+Shift+DIn a terminal
Close terminalCmd+WCtrl+WIn a terminal
Focus preview addressCmd+LCtrl+LIn the browser preview
Refresh previewCmd+RCtrl+RIn the browser preview
Zoom preview inCmd+= or Cmd++Ctrl+= or Ctrl++In the browser preview
Zoom preview outCmd+-Ctrl+-In the browser preview
Reset preview zoomCmd+0Ctrl+0In the browser preview

Toggle diff shows the Changes panel. Split terminal vertically adds a pane below the active one. Close terminal closes the active pane. Close right panel closes the panel that is showing. When no panel is open, OpenWaggle passes the key on to whatever has focus.

Go to pending request moves focus to a request waiting for you, without moving your cursor in the message box. It never answers the request. Press Escape to go back to your message.

Copy session link copies a link to the session you have open. Some Linux desktops lock the screen on Ctrl+Alt+L. If yours does, choose another key.

Command palette, Go to file and New session must always keep at least one shortcut.

Shortcuts also work inside the browser preview page, but ordinary typing stays in the page field that has focus.

On keyboards where Ctrl+Alt (AltGr) with a key types a character, such as Ctrl+Alt+L for ł on a Polish keyboard or Ctrl+Alt+B for { on Czech and Hungarian keyboards on Windows, the character goes to the field or terminal you are typing in, and the shortcut works everywhere else. In the browser preview on Windows, a letter such as ł always goes to the page, while a symbol such as { can still run a matching Ctrl+Alt shortcut.

Panel shortcuts

Each view the right panel can show has a command. Its shortcut shows that panel, or closes the right panel when that panel is already showing, the same as clicking its icon on the panel rail. Panel shortcuts don’t work while you type in a terminal, except Toggle preview, which works everywhere.

PanelCommandDefault
All panelsToggle All panelsUnassigned
ChangesToggle diffCmd/Ctrl+D
Project ActionsToggle Project ActionsUnassigned
ScheduledToggle ScheduledUnassigned
BrowserToggle previewCmd/Ctrl+Shift+J
FilesToggle FilesUnassigned
Session TreeToggle session treeCmd/Ctrl+Shift+Y
ResourcesToggle ResourcesUnassigned
HiveToggle HiveUnassigned
Extension side panelsThe panel’s nameUnassigned

Assign them under Settings > Shortcuts > Panels. That group lists the built-in panels, Toggle right panel, and each installed extension’s side panels under the extension’s name. Record a key combination, then click Save. The reset button returns a built-in panel to its default, and the clear button unassigns it.

Extensions cannot choose shortcuts for their panels. Only you can. A panel shortcut must be unique. OpenWaggle refuses one that a built-in command, a reserved key or another panel already uses, and names what uses it.

An extension panel’s shortcut does nothing while the panel cannot be shown, for example while its extension is disabled, untrusted or waiting for an update, and the key goes to whatever has focus. The shortcut is kept when you uninstall the extension. It is listed under Extensions not installed, where you can remove it, and it works again if you reinstall the extension.

Fixed keys

These keys cannot be changed. If you give another command Cmd/Ctrl+F or Cmd/Ctrl+1 to Cmd/Ctrl+9, Settings > Shortcuts marks it as a conflict with the sidebar.

macOSWindows and LinuxWhat it doesWhere
EnterEnterSends the messageMessage box
Shift+EnterShift+EnterStarts a new lineMessage box
ArrowUpArrowUpRecalls your previous messageMessage box, cursor at the start
ArrowDownArrowDownRecalls your next messageMessage box, cursor at the end
EscapeEscapeStops editing a queued messageMessage box, while editing a queued message
Cmd+FCtrl+FFilters projects and sessionsOutside Settings
EscapeEscapeClears the filterSidebar filter field
Cmd+1 to Cmd+9Ctrl+1 to Ctrl+9Opens pinned session 1 to 9Main window
Option+ArrowUp, Option+ArrowDownAlt+ArrowUp, Alt+ArrowDownMoves a panel up or down the railPanel rail icon
Cmd+EnterCtrl+EnterSubmits a diff comment or reviewDiff comment field
EscapeEscapeCancels a diff comment or reviewDiff comment field

Cmd/Ctrl+F focuses the filter field at the top of the sidebar, and opens the sidebar first if it is collapsed. Escape in that field clears both the text and any state chip.

Cmd/Ctrl+1 to Cmd/Ctrl+9 open the first nine rows of the Pinned section, in the order the section shows now, so they follow a reorder or a sort change. Positions count the whole section before any filter, so a pin’s badge and its shortcut always mean the same session, even while a filter hides rows. You can pin a tenth session, but it gets no shortcut.

Session Tree keys

Open the Session Tree from Session Tree on the panel rail, with Cmd/Ctrl+Shift+Y, or from Session Tree in the command palette’s Panels section. These keys work while focus is in the tree:

KeyWhat it does
ArrowUp, ArrowDownMoves focus
ArrowRightExpands the focused node, or moves to its first child
ArrowLeftCollapses the focused node, or moves to its parent
EnterSelects the focused node
EscapeCloses the Session Tree

How bindings combine

Settings > Shortcuts lists built-in commands and project action shortcuts together, with a search field. A command can have several bindings, in order. You record a key combination, then use the condition builder or its expression field to say where it applies. Settings highlights conflicts, but you can save one on purpose. You can edit and reset default bindings, and remove custom ones.

RuleWhat it means
Project actions firstA matching project action shortcut wins over a built-in command, however recently you edited the built-in.
Last match winsWithin each ordered list of bindings, the last one that matches applies.
Same key, different placesBindings can share a key when their conditions do not overlap.

Conditions use these names, combined with !, &&, || and parentheses:

ConditionTrue when
terminalFocusYou are typing in a terminal.
terminalOpenThe terminal is open.
previewFocusThe browser preview has focus.
previewOpenThe browser preview is open.
modelPickerOpenThe model selector is open.

OpenWaggle keeps an unknown condition name, so a binding made for a newer version still loads, and the condition counts as false.

You can also edit a project action’s shortcuts with the action itself in Settings > Project actions. A binding can apply everywhere or only under a condition. See Project actions.