Keyboard Shortcuts

On macOS, Cmd refers to the Command key. The shortcuts below are the defaults; the ones that come from trm's Ghostty core can be rebound with keybind = lines in config.toml (for example keybind = global:ctrl+alt+backquote=toggle_quick_terminal_remote), while the ones attached to menu items are fixed.

Pane Management

Shortcut	Action
`Cmd+N`	Add a new pane to the right in the current row
`Cmd+Option+N`	Add a new row with one pane
`Cmd+Shift+N`	Open a new window
`Cmd+W`	Close the focused pane
`Cmd+R`	Rename the focused pane (opens rename overlay)

Shortcut	Action
`Cmd+1` through `Cmd+9`	Jump to pane by number (1-indexed)
`Cmd+]`	Focus the next pane (wraps)
`Cmd+[`	Focus the previous pane (wraps)
`Cmd+Option+Left`	Focus the pane to the left
`Cmd+Option+Right`	Focus the pane to the right
`Cmd+Option+Up`	Focus the pane above
`Cmd+Option+Down`	Focus the pane below
`Cmd+Shift+Left`	Swap focused pane with the neighbor to the left
`Cmd+Shift+Right`	Swap focused pane with the neighbor to the right
`Cmd+Shift+Up`	Swap focused pane with the neighbor above
`Cmd+Shift+Down`	Swap focused pane with the neighbor below

Directional focus moves through the grid as it is drawn, not as the panes were created, so it follows what you rearranged. Rows may be ragged: moving up or down from a column a shorter row doesn't have lands on that row's last pane. At an edge the key is left alone and reaches the terminal, so Cmd+Option+Left in the leftmost pane still does whatever your shell does with it.

Shortcut	Action
`Cmd++` / `Cmd+=`	Increase font size by 2pt
`Cmd+-`	Decrease font size by 2pt
`Cmd+0`	Reset font size to the configured default

Broadcast and Multi-Select

Shortcut	Action
`Cmd+Shift+B`	Toggle broadcast mode (type in all terminal panes at once)
`Shift+Click+Drag`	Rectangle-select multiple panes
`Cmd+Click`	Toggle a single pane in/out of the selection
`Cmd+Shift+D`	Deselect all panes

When multiple panes are selected, the command overlay targets only those panes.

The Shelf

Shortcut	Action
`Cmd+Ctrl+S`	Show or hide the sidebar shelf
`Cmd+Ctrl+H`	Send the focused pane to the shelf — it keeps running
`Ctrl+Click` a pane's bar	The same thing, where your hand already is

A parked pane keeps its shell, its agent and whatever it was doing; the grid expands into the space it left. Click a tile to bring it back, ⌘-click to read it where it is, double-click its name to rename it.

Agents

Shortcut	Action
`Cmd+Shift+A`	Toggle the Command Center — every agent in every window
`Ctrl+` `	Drop down the quick terminal
`Ctrl+Option+` `	Drop down the quick terminal on the remote machine

In the Command Center: click a row to reply to that agent, ⌘-click to open its Agent Overview, double-click a row's header to go to the pane. The panel header has a briefing toggle and a full-view button that gives the board the whole window.

Command Palette

Shortcut	Action
`Cmd+Shift+Enter`	Open the command palette (AI mode by default)
`Option+Option`	Double-tap Option within 400ms to open the command palette

Command Palette Modes

Mode	Prefix	Description
AI	(none)	Default. Send a prompt to the LLM for intelligent terminal control
Search	`@`	Fuzzy search over built-in commands
Command	`!`	Send raw command to focused/targeted panes

Inside the Command Palette

Shortcut	Action
`Escape`	Close the palette
`Enter`	Submit the prompt / execute the selected command
`Up` / `Down`	Navigate search results (in Search mode)
`Backspace`	Delete last character
`Space`	Toggle pane selection (when in target mode)

Pane Overlaying

Shortcut	Action
`Cmd+Shift+O`	Add an overlay background pane to the current cell
`Cmd+Shift+}`	Swap foreground and background layers
`Cmd+Shift+W`	Close the overlay (background) pane
`Tab`	Toggle focus between foreground and background layers

Rename Overlay

Shortcut	Action
`Escape`	Cancel rename
`Enter`	Confirm rename
`Backspace`	Delete last character

Help Overlay

Shortcut	Action
`Cmd+/` or `Cmd+?`	Toggle the help overlay
`Escape`	Close the help overlay
`Up` / `k`	Scroll up
`Down` / `j`	Scroll down
`Page Up`	Scroll up 10 lines
`Page Down`	Scroll down 10 lines
`Home`	Scroll to top

Text Selection

Shortcut	Action
`Click+Drag`	Select text in a terminal pane
`Double-Click`	Select a word
`Ctrl+Click`	Select contiguous non-space text (URLs, paths) across wrapped lines
`Ctrl+Click+Drag`	Extend selection by space boundaries, crossing all line breaks
`Escape`	Clear the current selection

Other

Shortcut	Action
`Cmd+,`	Open `config.toml` in your default editor

Terminal Input

Standard terminal key sequences are forwarded to the focused pane:

Enter, Backspace, Tab, Escape
Arrow keys (Up, Down, Left, Right)
Home, End, Page Up, Page Down
Insert, Delete
F1 through F12
Ctrl+C, Ctrl+D, Ctrl+Z, and all other Ctrl combinations