Fix Tmux hotkeys in README to match actual tmux.conf bindings - #9
Conversation
Cmd key cannot be forwarded through macOS terminals to tmux, so all Ctrl+Cmd and Ctrl+Shift+Page* chords were impossible. Replace with the real bindings from tmux.conf: prefix-based h/v/x for pane splits/kill, Ctrl+Option+arrows for pane focus/resize, Option+arrows and prefix+c/k/r for windows, and prefix+Shift+c/k/r/p/n plus Option+Up/Down for sessions. Also fix 'kill window' which incorrectly listed prefix+x (kills a pane). Add missing Option+1-9 window jump and Option+Shift+arrow swap bindings.
There was a problem hiding this comment.
Pull request overview
Updates the README’s tmux hotkey documentation so it reflects usable macOS key chords and the intended tmux prefix-based workflow.
Changes:
- Replaced impossible
Ctrl + Cmd + …andCtrl + Shift + Page*tmux chords with prefix-based and Option-based bindings. - Corrected window vs pane kill shortcuts and expanded window navigation/swap/jump shortcuts.
- Updated session management shortcuts to match the documented prefix/Option navigation model.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| | `Prefix + h` | Split horizontally (new pane below) | | ||
| | `Prefix + v` | Split vertically (new pane to the right) | | ||
| | `Prefix + x` | Kill pane | |
There was a problem hiding this comment.
These keybindings are described as coming from tmux.conf, but there’s no tmux.conf (or tmux config) in this repo (it looks like tmux config comes indirectly via the Omadots installer). Consider linking to the exact upstream config file/commit that defines these bindings (or adding the tmux config here) to prevent the README hotkey list from drifting again.
| | `Ctrl + ⌥ + Shift + ←` | Resize left | | ||
| | `Ctrl + ⌥ + Shift + ↓` | Resize down | | ||
| | `Ctrl + ⌥ + Shift + ↑` | Resize up | | ||
| | `Ctrl + ⌥ + Shift + →` | Resize right | |
There was a problem hiding this comment.
PR description says pane focus/resize uses Ctrl + ⌥ + arrow, but the README documents resize as Ctrl + ⌥ + Shift + arrow. Please align the PR description/test plan with what’s documented here (or update the documented shortcuts if Shift isn’t actually required).
Summary
Ctrl + Cmd + …andCtrl + Shift + Page*chords in the Tmux section were impossibletmux.confuse prefix-based keys (h/v/x),Ctrl + ⌥ + arrowfor pane focus/resize,⌥ + arrowfor window navigation, andPrefix + Shift + c/k/r/p/n/⌥ + ↑↓for sessions.Prefix + x(that kills a pane; kill-window isPrefix + k).⌥ + 1–9window-jump and⌥ + Shift + ←/→swap-window bindings.Test plan
Prefix + h/Prefix + vcreate pane splits.Ctrl + ⌥ + arrowmoves between panes.⌥ + ←/→switches windows,⌥ + 1–9jumps to window N.Prefix + Shift + ccreates a new session and⌥ + ↑/↓switches between sessions.