Send macOS Option as Meta and restore arrow shortcuts

This commit is contained in:
James Magahern
2026-11-17 16:10:18 -08:00
parent 57ec12d238
commit cb842c66cb
4 changed files with 120 additions and 37 deletions
+10 -8
View File
@@ -166,10 +166,10 @@ run `psyterm --shutdown` on the remote host, for example through SSH.
| Increase terminal text size | Cmd+Plus or Cmd+= | Ctrl+Plus or Ctrl+= |
| Decrease terminal text size | Cmd+Minus | Ctrl+Minus |
| Open or dismiss the command palette | Cmd+Shift+P | Ctrl+Shift+P |
| Create a tab | Cmd+T | Ctrl+Shift+T |
| Create a tab | Cmd+T or Option+Shift+Left / Right | Ctrl+Shift+T |
| Add a pane to the right | Cmd+D | Ctrl+Shift+D or Alt+\ |
| Insert a stacked pane above / below | Option+Shift+Up / Cmd+Shift+D | Alt+Shift+Up / Down |
| Focus the adjacent pane or tab | Cmd+Option+Left / Right | Alt+Left / Right |
| Focus the adjacent pane or tab | Option+Left / Right or Cmd+Option+Left / Right | Alt+Left / Right |
| Switch tabs | Cmd+Shift+[ / ] | Alt+Shift+[ / ] |
| Focus the previous / next stacked pane | Cmd+Option+Up / Down | Alt+Up / Down |
| Cycle through panes | Cmd+[ / ] | Ctrl+Shift+Left / Right |
@@ -189,10 +189,9 @@ Choose **Rename tab** in the palette to edit the selected tab's name. When
renaming a pane or tab, press Enter to save or Escape to cancel. Saving a blank
name restores automatic naming.
Both platforms also support the Alt shortcuts from Zellij's `shared` map and
Alt+\ from its `locked` map. On macOS, Alt is the Option key.
Alt+Shift+N and Alt+Shift+Right also create a tab. Plain Ctrl shortcuts such
as Ctrl+C and Ctrl+D reach the terminal.
On Linux, the Alt shortcuts follow Zellij’s `shared` map, with Alt+\ from its
`locked` map. Alt+Shift+N and Alt+Shift+Right also create a tab. On macOS,
Option+Up/Down also focus stacked panes, and Option+Shift+Up/Down insert them.
The command palette searches command names and keywords as you type. Arrow keys
or Tab select a result; Enter runs it or opens a submenu. Escape returns to the
@@ -201,8 +200,11 @@ live workspace lists, including collapsed panes. Commands without shortcuts,
such as restoring automatic pane names, are available here too. Palette input
never reaches the shell.
Typing returns to the live screen. Ctrl+C, Ctrl+D and unbound Alt combinations,
arrows, navigation keys, and function keys reach the terminal application.
Typing returns to the live screen. Unbound Alt/Option character keys send Meta.
On a Mac keyboard, Option+Delete (⌥⌫) sends Meta+Backspace, which deletes
the preceding word in Bash and Zsh’s Emacs keymaps. Option+B/F move by word.
Shift+Left/Right carry their xterm Shift modifier so a CLI can bind them.
Plain Ctrl shortcuts such as Ctrl+C and Ctrl+D reach the terminal.
Alternate-screen applications receive shifted navigation; the wheel sends
arrow keys when the application enables alternate scrolling.