Keyboard shortcuts

The native shortcuts and prefix controls worth keeping close.

Harness 2.0.12 min read
On this page

Everyday Mac controls

ActionShortcut
New window / tab / session⌘N / ⌘T / ⇧⌘N
Close pane / close tab⌘W / ⌥⌘W
Split horizontally / vertically⌘D / ⇧⌘D
Neighboring pane⌥⌘Arrow
Previous / next pane⌘[ / ⌘]
Zoom pane / equalize splits⇧⌘Return / ⌃⌘=
Select tab 1–9⌘1 … ⌘9
Previous / next tab⇧⌘[ / ⇧⌘]
Reopen closed tab⇧⌘T
Find / next / previous⌘F / ⌘G / ⇧⌘G
Go to directory⌥⌘G

⌘ is Command, ⌥ is Option, ⌃ is Control, and ⇧ is Shift. Closing a pane is an explicit close action, not merely hiding a window.

Full Terminal prefix controls

Full Terminal enables Ctrl-A by default. Press and release the prefix, then the next key. Press prefix followed by ? for the live cheatsheet. These are defaults; your keymap may override them.

After the prefixAction
% / "Split side-by-side / stacked
cNew tab
n / pNext / previous tab
zZoom pane
oCycle panes
qShow pane numbers
[Enter copy mode
:Open command prompt
dDetach attached client
xClose pane

GUI prefix arrows select neighboring panes. The attach-window compositor uses hjkl for pane movement. Do not assume every native GUI binding is identical in a terminal attach client.

Inspect and change your bindings

Terminal
harness-cli keymap --json
harness-cli list-keys
harness-cli bind-key -T prefix '|' split-window -h

Keybinding overrides are merged over defaults and can be managed with bind-key/unbind-key or keybindings.json. Lua can also contribute bindings. Use keymap to inspect the effective source of each binding before troubleshooting a conflict.

File paths and workspace actions

ActionShortcut or menu
Insert Path⌥⌘I
Go to Directory⌥⌘G
ActivitySession → Activity…
Saved SetupsSession → Saved Setups…
Recently ClosedSession → Recently Closed…
Search retained output across sessionsSession → Search All Sessions…

The command palette also exposes workspace actions. Insert Path uses Return to insert, Right or Tab to open a folder, Left to go up, and Escape to close. It does not send a Return to the shell.

Source references Harness 2.0.1

Checked against the immutable shipping commit for Harness 2.0.1. For other versions, consult the installed CLI’s help and schemas.