Keyboard shortcuts

Termio is built to run from the keyboard. The tables below are generated from the app’s command catalog, so they list exactly what this version ships. Every command is rebindable — see Customizing.

Sessions and projects

New Terminal opens the shell where you already are — the working directory of the focused session — and puts the new session beside it, in the same project. New Terminal at Home always starts at ~; it ships unbound, so bind it under Customizing if that is the one you reach for.

Cycling follows the sidebar’s visual order, so ⇧⌘] moves to the next session as you see it listed, not in the order the sessions were created.

Workspaces

⌘1 through ⌘9 switch to the first nine workspaces, in the order the switcher lists them. They aren’t in the table below and they aren’t rebindable, because they’re positional: what ⌘2 reaches changes when the list does, and a binding whose target moves isn’t one you can keep. The switcher draws the digit beside each name so you read the number instead of remembering it. See Workspaces.

Finding things

Both panels are fuzzy-matched. The Command Palette runs actions; Open Quickly jumps to things — sessions, projects, and files. See Command palette & Open Quickly.

Panes

Split Left and Split Up ship unbound, the way Ghostty ships them: the two directions people reach for constantly get the keys, and the mirrored pair stays a menu verb until you bind it yourself. Both are always available from the Command Palette and the pane’s context menu.

⌘W is Close Session, the way ⌘W closes a tab in a browser: it ends the focused session, and its pane collapses with it. Once no session is left, ⌘W closes the window — the app keeps running with every other session alive.

Ungroup is the other half, and it ships unbound: it takes the focused pane out of the group and leaves the session running on its own. It’s in the View menu, the Command Palette, and the pane’s context menu, and you can give it a key in Settings ▸ Keyboard.

Panes can also be rearranged with the mouse: hover a pane’s header, grab the handle that appears, and drop the pane on a neighbour. A highlight previews the drop — an edge half places the pane on that side, the center swaps the two.

Branches and worktrees

Termio takes these two bindings from GitHub Desktop’s Branch menu verbatim, where New Branch is ⇧⌘N. Termio’s branch-creation verb is the worktree.

View

The system shortcuts you’d expect work as usual — ⌘C / ⌘V to copy and paste, ⌘A to select all, ⌘, for Settings, ⌘Q to quit.

The Mac find keys belong to the editor: ⌘F opens the find bar, ⌘G and ⇧⌘G step through matches, and ⌘E makes the selection the query. They’re fixed rather than rebindable — they only mean anything while a file is open, and the terminal never sees them.

Customizing

Open Settings ▸ Keyboard to rebind any command. The editor lists every action with its current binding and flags conflicts as you assign them. Your overrides are saved to:

~/.termio/keybindings.json

Only the shortcuts you change are written there — the defaults ship with the app, so the file stays small and easy to read.

A binding must include ⌘. Without it, the chord would collide with what the terminal itself needs: an agent’s TUI expects ⌃C, ⌥←, and the rest to reach it untouched.