Skip to content

Keyboard shortcuts

Shortcuts are grouped by where they work. Terminals take shell keystrokes first, but Session and terminal-layout shortcuts still work inside them.

Shortcut Action
⌘K Open the command palette
⌘P Open quick open to find a file
⌘, Open or raise the Settings window
⇧⌘S Show or hide the project rail
C Open New ticket
⌘1 to ⌘9 Switch to the first through ninth project in the rail
⌘B Toggle the sidebar
⌥⌘B Toggle the visible ticket or Home rail
⌘T Start a chat Session on the visible ticket or project
⌥⌘T Start a terminal companion on the visible ticket or project
⌥⌘Enter Enter or leave terminal focus mode for the visible terminal
⌘[ Back
⌘] Forward
⌘+ / ⌘- / ⌘0 Zoom the app in, out, or back to actual size

The command palette searches tickets and Sessions across every project. Selecting a Session opens it. Selecting a ticket opens its workspace, switching projects if the ticket belongs to another one.

C is a bare keypress with no modifier, so Volli suppresses it while you type: in text fields, the editor, a terminal, or an open dialog. Volli also suppresses ⌘[ while you type, because it means outdent inside an editor.

Settings opens in a separate, nonmodal window. ⌘, raises that window without resetting its current page, search, or drafts. You can keep working in the workspace while it stays open.

⌘P searches files in the visible ticket’s working copy, or the project’s main checkout when you are outside a ticket. The index reloads each time you open it.

Shortcut Action
↑ / ↓ Select a result
Enter Open a preview in the focused pane
⌘Enter Open and pin the file
Esc Close quick open

You can also ⌘-click a result to pin it.

These shortcuts act on the tabbed view in front of you: Home or a ticket workspace. Splitting a full-width tab creates a group of panes; splitting an existing group acts on its focused pane.

Shortcut Action
⌘\ Split the focused pane to the right
⇧⌘\ Split the focused pane down
⌃⌘ + ← / → / ↑ / ↓ Move focus between panes

These shortcuts do nothing inside an open dialog or menu, on the Automations page, or while a terminal has the whole canvas. The separate Settings window has no workspace panes to split.

Shortcut Action When
Esc Deselect the selected card A card is selected
Enter Open a focused card A card has keyboard focus
Enter Add the card and keep the composer open The inline composer is open
Esc Close the inline composer The inline composer is open
⌥ (Option) Expand the hovered column’s Offered list A card is being dragged
1–9 Choose the matching offered Automation A card is being dragged
0 Choose Move only A card is being dragged

During a drag, you can use the board’s compact Offered list without holding Option. Holding it makes the rows larger, so they are easier to hit. The enabled, armed Automation is pinned to 1; see Automations for the full move behavior.

Shortcut Action
⌘Enter Create the ticket
⇧⌘Enter Create the ticket and start its agent
Shortcut Action When
Esc Close the ticket and return to the board Nothing else has focus
⌘Enter Post a comment The comment box has focus
Esc Cancel an in-progress comment edit You’re editing a comment

Esc won’t close the ticket while a terminal has focus. It goes to the terminal instead.

Peek shortcuts work in the sidebar’s Session lists and a ticket’s Now → Sessions.

Shortcut Action When
Space Peek at the focused Session; press again to reply from the card A Session row has focus
↑ / ↓ or K / J Move to the previous or next row A Session row has focus
U Mark the focused Session read or unread A Session row has focus
⌘. Reply from the card on screen A peek card is open
Esc Leave the reply field, then close the card A peek card is open

The sidebar also supports row selection and ticket folders:

Shortcut Action
⌘-click Toggle a row in the selection without opening it
⇧-click Select a range of rows
⌘A Select all currently listed rows while focus is in the Session list
Esc Clear the row selection before closing a peek card
→ / ← Expand or collapse the focused ticket folder
← Move from a Session inside a ticket folder to that folder

See Peek at a Session.

Shortcut Action
Enter Send when idle; queue a message while a turn runs
⌘Enter Send when idle; steer the current turn while it runs
⇧Enter Insert a new line
Enter Choose the active @ or / picker item when a picker is open
Esc Close the active picker

Queued messages also have Steer and Remove controls. See Use a chat.

Shortcut Action When
⌃⇧B (Control+Shift+B) Move the newest running bash command to the background Its Session’s transcript or composer has focus, and a shell slot is available

The command keeps running. Its transcript row also has Move to background.

Shortcut Action
⌘S Save the open file
Shortcut Action
⌘D Split the pane vertically
⇧⌘D Split the pane horizontally
⌘⌥← ⌘⌥→ ⌘⌥↑ ⌘⌥↓ Move focus to the adjacent pane
⌥⌘Enter Enter or leave terminal focus mode
⌘+ / ⌘- Change the terminal font size
⌘0 Reset the terminal font size
⌃⇧M (Control+Shift+M) Toggle Tab focus navigation for this terminal pane

Tab normally goes to the shell for completion. To leave the terminal with Tab, press Control+Shift+M, then Tab or Shift+Tab to move forward or backward through the app’s controls. Tab back into the terminal and press the chord again to restore shell completion. The mode survives hiding or moving the pane, and each split pane has its own mode. The terminal input’s accessible description and its hover text name the chord, and a notification confirms each mode change.

Terminal output is exposed as screen-reader rows, including scrollback navigation, with each region named for its tab and pane number. VoiceOver users can navigate the rows to read output instead of relying only on live announcements.

Font-size shortcuts change the focused terminal only. To scale the whole app, move focus out of the terminal first.

These work while a Browser Tab’s page has focus, including inside a text field on the page.

Shortcut Action
⌘K Open the command palette
⌘1 to ⌘9 Switch to the first through ninth project in the rail
⌃⌘ + ← / → / ↑ / ↓ Move focus between panes
⌘W Close this Browser Tab
⌘L Leave the page and select this tab’s Address field

Every other key goes to the page, including Esc, Tab, ⌘[ and ⌘], so the page’s own dialogs, forms and editors keep working.

Shortcut Action When
← → ↑ ↓ Move the color 1% across the pad A color on the pad has focus
⇧ + an arrow Move the color 5% across the pad A color on the pad has focus
← → ↑ ↓ Change vibrancy or grain by 1% A fader has focus
Enter Apply the typed hex The primary color’s hex field has focus
Esc Discard the typed hex The primary color’s hex field has focus

Every other edit saves as you make it. See Theming.