SPB Git

Repository Public

SHORTCUTS.md 2.3 KB

# NEXTERM keyboard shortcuts

All NEXTERM shortcuts use ⌘ so they never reach the shell or TUI programs (which only receive unmodified, ⌃ and ⌥ keys). SwiftTerm forwards ⌘-keys to the menu bar before the terminal sees them; the only exception is a program that explicitly enables the Kitty keyboard protocol with ⌘ reporting (shouldSendCommandKeyToTerminal), which NEXTERM leaves off by default.

Action Default Menu
New Window ⌘N File
New Tab ⌘T File
Close Pane (closes the tab when it is the last pane) ⌘W File
Close Tab ⇧⌘W File
Split Right (vertical divider) ⌘D Shell
Split Down (horizontal divider) ⇧⌘D Shell
Clear Screen and Scrollback ⌘K Shell
Find… / Find Next / Find Previous ⌘F / ⌘G / ⇧⌘G Shell
Focus Next / Previous Pane ⌘] / ⌘[ Pane
Focus Left / Right / Up / Down ⌥⌘← / ⌥⌘→ / ⌥⌘↑ / ⌥⌘↓ Pane
Maximize / Restore Pane ⇧⌘↩ Pane
Equalize Panes ⌥⌘= Pane
Move Pane to New Window ⌥⌘N Pane
Next / Previous Tab ⇧⌘] / ⇧⌘[ View
Tab 1 … 8 ⌘1 … ⌘8 View
Show/Hide Sidebar ⌃⌘S View
Show/Hide Inspector ⌃⌘I View
Focus Mode (hide all chrome) ⌃⌘F View
Zoom In / Out / Actual Size ⌘+ / ⌘- / ⌘0 View
Command Palette ⇧⌘P View (Phase 5)
Mission Control ⇧⌘M Window (Phase 3)
Workspace Switcher ⌃⌘W Window (Phase 2)
Copy / Paste / Select All ⌘C / ⌘V / ⌘A Edit (standard responder chain)
Settings ⌘, NEXTERM

Inside the terminal, the usual control keys (⌃C, ⌃D, ⌃Z, ⌃R…) go straight to the program. Option acts as Meta by default (Settings → Behavior).

# Customisation

Settings ▸ Keys lists every action with its default. Enter a shortcut as cmd+shift+t, ctrl+cmd+g, cmd+return, cmd+] … (modifiers: cmd, shift, option/alt, ctrl; keys: single characters, return, escape, space, tab, delete, up/down/left/right). A shortcut must include ⌘ — anything else is rejected so it can never collide with the shell. Conflicts between two actions are flagged in the same pane. Overrides live in the settings table (app.settings → keybindings) and take effect at the next launch, because SwiftUI builds the menu bar once.

Files main
Menu

Theme