Keyboard shortcuts
Shortcuts are grouped by where they work. Terminals take shell keystrokes first, but Session and terminal-layout shortcuts still work inside them.
Global
Section titled “Global”| 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.
Quick open
Section titled “Quick 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.
New ticket dialog
Section titled “New ticket dialog”| Shortcut | Action |
|---|---|
⌘Enter |
Create the ticket |
⇧⌘Enter |
Create the ticket and start its agent |
Ticket detail
Section titled “Ticket detail”| 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.
Session lists
Section titled “Session lists”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.
Session composer
Section titled “Session composer”| 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.
Running commands
Section titled “Running commands”| 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.
File editor
Section titled “File editor”| Shortcut | Action |
|---|---|
⌘S |
Save the open file |
Terminal
Section titled “Terminal”| 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.
Browser Tab
Section titled “Browser Tab”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.
Canvas editor
Section titled “Canvas editor”| 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.