Reference

Keyboard Shortcuts

Rebind any of these in Settings › Keyboard, or with keybind in the configuration file.

On Windows and Linux, Ctrl with a letter belongs to the shell (Ctrl D, Ctrl R, Ctrl W…), so Hyla's shortcuts add Shift, as Windows Terminal's do, or use Alt. A dash means the action has no shortcut there.

Hyla

Action macOS Windows & Linux Action id
Settings… ⌘ , Ctrl , settings.open
Quit (sessions keep running) ⌘ Q Ctrl Shift Q
Quit and End All Sessions… ⌘ ⌥ Q – app.quitAll

Session

Action macOS Windows & Linux Action id
New Session ⌘ T Ctrl Shift T session.new
New Session in Home ⌘ ⇧ T – session.newHome
New Session in Worktree… ⌘ ⌥ T – session.newWorktree
Open Project… ⌘ O Ctrl Shift O project.open
Go to Session… ⌘ P Ctrl Shift P palette.open
Resume Conversation… ⌘ ⇧ O – conversation.resume
Jump to Session Needing You ⌘ J Ctrl Shift J session.attention
Next Session ⌘ ⇧ ] Ctrl PgDn session.next
Previous Session ⌘ ⇧ [ Ctrl PgUp session.previous
Rename Session ⌘ R – session.rename
Restart Pane ⌘ ⇧ R Ctrl Shift R pane.restart
Close ⌘ W Ctrl Shift W pane.close
Close Session ⌘ ⇧ W – session.close

⌘ 1–9 (Ctrl 1–9 on Windows and Linux) go to the sidebar's sessions, and Ctrl Tab to the next one.

Pane

Action macOS Windows & Linux Action id
Split Right ⌘ D Alt Shift = pane.split.right
Split Down ⌘ ⇧ D Alt Shift - pane.split.down
New Browser Pane ⌘ ⇧ B Alt Shift B pane.browser
Open Location ⌘ L – browser.address
Zoom Pane ⌘ ⇧ ↩ Ctrl Shift Enter pane.zoom
Next Pane ⌘ ] Ctrl Shift ] pane.next
Previous Pane ⌘ [ Ctrl Shift [ pane.previous
Pane Left ⌘ ⌥ ← Alt ← pane.left
Pane Right ⌘ ⌥ → Alt → pane.right
Pane Above ⌘ ⌥ ↑ Alt ↑ pane.up
Pane Below ⌘ ⌥ ↓ Alt ↓ pane.down

View

Action macOS Windows & Linux Action id
Toggle Sidebar ⌘ B Ctrl Shift B sidebar.toggle
Toggle Side Panel ⇧ ⌘ E Ctrl Shift E side.toggle
Toggle Changes ⌥ ⌘ G Ctrl Shift G changes.toggle
Toggle Files (this fork opens the side panel) ⌥ ⌘ F Ctrl Alt F files.toggle
Show/Hide Info ⌥ ⌘ I Ctrl Alt I info.toggle
Bigger ⌘ = Ctrl = text.bigger
Smaller ⌘ - Ctrl - text.smaller
Actual Size ⌘ 0 Ctrl 0 text.reset
Quick Terminal ⌃ ` Ctrl ` quickTerminal.toggle

Quick terminal

The quick terminal drops over Hyla's panes, as wide as they are and half the window tall, starting at their top left, and goes back up when you press its shortcut again or click elsewhere. With Hyla's window hidden, minimized or on another space, it drops from the top of the screen instead. Its shortcut is Control `, as Ghostty's, and works in every app; give it another, or none, in Settings › Keyboard, or in the configuration file:

ini
keybind = global:ctrl+`=quickTerminal.toggle

It shows a session of its own, named Quick Terminal, which keeps running while it's hidden and after you quit Hyla, and which the sidebar lists with the others. When its shell exits, the next press starts a new one. View › Quick Terminal and the menu bar icon's menu open it too, and hyla do quickTerminal.toggle toggles it from a script.

On Wayland, the desktop binds the shortcut through the XDG desktop portal and may ask you to confirm it; desktops without the portal's global shortcuts can bind hyla do quickTerminal.toggle to a key in their own keyboard settings.