This page is partly generated. Six regions are rewritten from the tracked
configs by ./update-keybindings.sh; everything outside the fences is
hand-written. Run ./update-keybindings.sh --check to verify it is current
(./setup-validate.sh does this for you).
Terms like leader, prefix, mode and chord are defined in
CONTEXT.md. Two things to know before reading the tables:
- The Neovim leader is Space, so
<leader>fs means
Space f s.
- Some rows are marked inherited rather than
declared. Those work because tmux ships them by
default, not because this repo configures them — see
Gotchas.
Quick reference
| Action | Keys | Where |
| Copy / paste | Cmd+C / Cmd+V | Ghostty, Alacritty |
| Multiplexer prefix | Ctrl+A | tmux |
| Toggle pane zoom | Cmd+B, or prefix+z | Ghostty → tmux |
| New session popup | prefix+Ctrl+n | tmux |
| Lazygit popup | prefix+Ctrl+y | tmux |
| Session picker | prefix+Ctrl+j, prefix+w | tmux |
| Restore session (tmux-resurrect) | prefix+Ctrl+r | tmux — not yazi, see Gotchas |
| Scratch shell popup | prefix+Ctrl+t | tmux |
Edit ~/.zshrc in nvim | prefix+Ctrl+z | tmux |
| Focus pane | prefix+h/j/k/l, Shift+arrows | tmux |
| Split side-by-side | prefix+v, prefix+% | tmux |
| Split stacked | prefix+s, prefix+' | tmux |
| Next / previous window | prefix+n/p, Ctrl+Right/Left | tmux |
| Reload tmux config | prefix+r | tmux |
| Focus window | Alt+h/j/k/l | AeroSpace |
| Move window | Alt+Shift+h/j/k/l | AeroSpace |
| Switch workspace | Alt+1…Alt+9 | AeroSpace |
| Tiling layout / accordion | Alt+/ / Alt+, | AeroSpace |
| Format buffer | Space f s | Neovim |
| Diagnostics refresh | Space d r r | Neovim |
| Directory suggestion | Ctrl+F | zsh |
Layer 1 — Window manager (AeroSpace)
AeroSpace owns the outermost layer: it lays out macOS windows and switches
workspaces, so these keys work no matter which app has focus. Bindings live in per-mode
tables in aerospace.toml.
Focus & navigate
No matches.
| Key | Action | Mode |
| alt-h | focus left | main |
| alt-j | focus down | main |
| alt-k | focus up | main |
| alt-l | focus right | main |
Switch mode
No matches.
| Key | Action | Mode |
| alt-shift-h | join-with left, mode main | service |
| alt-shift-j | join-with down, mode main | service |
| alt-shift-k | join-with up, mode main | service |
| alt-shift-l | join-with right, mode main | service |
| alt-shift-r | mode resize | main |
| alt-shift-semicolon | mode service | main |
| backspace | close-all-windows-but-current, mode main | service |
| enter | mode main | resize |
| esc | mode main | resize |
| esc | reload-config, mode main | service |
| f | layout floating tiling, mode main | service |
Move & swap
No matches.
| Key | Action | Mode |
| alt-shift-h | move left | main |
| alt-shift-j | move down | main |
| alt-shift-k | move up | main |
| alt-shift-l | move right | main |
Layout
No matches.
| Key | Action | Mode |
| alt-comma | layout accordion horizontal vertical | main |
| alt-slash | layout tiles horizontal vertical | main |
Sessions & workspaces
No matches.
| Key | Action | Mode |
| alt-1 | workspace 1 | main |
| alt-2 | workspace 2 | main |
| alt-3 | workspace 3 | main |
| alt-4 | workspace 4 | main |
| alt-5 | workspace 5 | main |
| alt-6 | workspace 6 | main |
| alt-7 | workspace 7 | main |
| alt-8 | workspace 8 | main |
| alt-9 | workspace 9 | main |
| alt-b | workspace B | main |
| alt-e | workspace E | main |
| alt-m | workspace M | main |
| alt-n | workspace N | main |
| alt-p | workspace P | main |
| alt-shift-1 | move-node-to-workspace 1 | main |
| alt-shift-2 | move-node-to-workspace 2 | main |
| alt-shift-3 | move-node-to-workspace 3 | main |
| alt-shift-4 | move-node-to-workspace 4 | main |
| alt-shift-5 | move-node-to-workspace 5 | main |
| alt-shift-6 | move-node-to-workspace 6 | main |
| alt-shift-7 | move-node-to-workspace 7 | main |
| alt-shift-8 | move-node-to-workspace 8 | main |
| alt-shift-9 | move-node-to-workspace 9 | main |
| alt-shift-b | move-node-to-workspace B | main |
| alt-shift-e | move-node-to-workspace E | main |
| alt-shift-m | move-node-to-workspace M | main |
| alt-shift-n | move-node-to-workspace N | main |
| alt-shift-p | move-node-to-workspace P | main |
| alt-shift-t | move-node-to-workspace T | main |
| alt-shift-tab | move-workspace-to-monitor --wrap-around next | main |
| alt-shift-v | move-node-to-workspace V | main |
| alt-t | workspace T | main |
| alt-tab | workspace-back-and-forth | main |
| alt-v | workspace V | main |
| r | flatten-workspace-tree, mode main | service |
Other
No matches.
| Key | Action | Mode |
| alt-shift-f | fullscreen | main |
| b | balance-sizes | resize |
| equal | resize smart +50 | resize |
| h | resize width -50 | resize |
| j | resize height +50 | resize |
| k | resize height -50 | resize |
| l | resize width +50 | resize |
| minus | resize smart -50 | resize |
Layer 2 — Multiplexer (tmux)
tmux sits inside the terminal. The prefix is
Ctrl+A (changed from the default Ctrl+B), so
every prefixed key is Ctrl+A then the second key.
Focus & navigate
No matches.
| Key | Command | Source |
| ( | switch-client -p | inherited |
| ) | switch-client -n | inherited |
| 0 | select-window -t :=0 | inherited |
| 1 | select-window -t :=1 | inherited |
| 2 | select-window -t :=2 | inherited |
| 3 | select-window -t :=3 | inherited |
| 4 | select-window -t :=4 | inherited |
| 5 | select-window -t :=5 | inherited |
| 6 | select-window -t :=6 | inherited |
| 7 | select-window -t :=7 | inherited |
| 8 | select-window -t :=8 | inherited |
| 9 | select-window -t :=9 | inherited |
| Down | select-pane -D | inherited |
| L | switch-client -l | declared |
| Left | select-pane -L | inherited |
| M | select-pane -M | inherited |
| M-n | next-window -a | inherited |
| M-p | previous-window -a | inherited |
| Right | select-pane -R | inherited |
| Up | select-pane -U | inherited |
| \' | command-prompt -T window-target -p index { select-window -t ":%%" } | inherited |
| \; | last-pane | inherited |
| h | select-pane -L | declared |
| k | select-pane -U | declared |
| l | select-pane -R | declared |
| m | select-pane -m | inherited |
| n | next-window | inherited |
| o | select-pane -t :.+ | inherited |
| p | previous-window | inherited |
| w | choose-tree -Zw | inherited |
Split
No matches.
| Key | Command | Source |
| * | new-pane | inherited |
| \" | split-window -v -c "#{pane_current_path}" | declared |
| \% | split-window -h -c "#{pane_current_path}" | declared |
| s | split-window -v -c "#{pane_current_path}" | declared |
| v | split-window -h -c "#{pane_current_path}" | declared |
Move & swap
No matches.
| Key | Command | Source |
| ! | break-pane | inherited |
| . | command-prompt -T target { move-window -t "%%" } | inherited |
| < | swap-window -t -1 \; select-window -t -1 | declared |
| > | swap-window -t +1 \; select-window -t +1 | declared |
| C-o | rotate-window | inherited |
| J | choose-tree -Z -F "#{E:@custom_choose_tree_format}" "join-pane -v -s %%" | declared |
| M-o | rotate-window -D | inherited |
| \{ | swap-pane -U | declared |
| \} | swap-pane -D | declared |
| b | if-shell " [ #{window_panes} -gt '1' ] " { break-pane -a } | declared |
| j | choose-tree -Z -F "#{E:@custom_choose_tree_format}" "join-pane -h -s %%" | declared |
Resize
No matches.
| Key | Command | Source |
| C-Down | resize-pane -D | declared |
| C-Left | resize-pane -L | declared |
| C-Right | resize-pane -R | declared |
| C-Up | resize-pane -U | declared |
| M-Down | resize-pane -D 5 | inherited |
| M-Left | resize-pane -L 5 | inherited |
| M-Right | resize-pane -R 5 | inherited |
| M-Up | resize-pane -U 5 | inherited |
| S-Down | resize-pane -D 5 | declared |
| S-Left | resize-pane -L 5 | declared |
| S-Right | resize-pane -R 5 | declared |
| S-Up | resize-pane -U 5 | declared |
| z | resize-pane -Z | inherited |
Layout
No matches.
| Key | Command | Source |
| M-1 | select-layout even-horizontal | inherited |
| M-2 | select-layout even-vertical | inherited |
| M-3 | select-layout main-horizontal | inherited |
| M-4 | select-layout main-vertical | inherited |
| M-5 | select-layout tiled | inherited |
| M-6 | select-layout main-horizontal-mirrored | inherited |
| M-7 | select-layout main-vertical-mirrored | inherited |
| Space | select-layout -n | declared |
Popups & launchers
No matches.
| Key | Command | Source |
| C-j | display-popup -E -T " Switch Session " -h "40%" -w "40%" "tmux list-sessions | sed -E 's/:.*$//' | grep -v \"^$(tmux display-message -p '#S')$\" | fzf --reverse | xargs tmux switch-client -t" | declared |
| C-n | display-popup -E -h "20%" -w "40%" "bash -c \"read -p \\\"New session name: \\\" name && [ -n \\\"\\\$name\\\" ] && tmux new-session -d -s \\\"\\\$name\\\" && tmux switch-client -t \\\"\\\$name\\\"\"" | declared |
| C-t | display-popup -E -d "#{pane_current_path}" -h "75%" -w "75%" zsh | declared |
| C-y | display-popup -E -d "#{pane_current_path}" -h "90%" -w "90%" lazygit | declared |
| C-z | display-popup -E -h "80%" -w "80%" "nvim ~/.zshrc" | declared |
Sessions & workspaces
No matches.
| Key | Command | Source |
| \$ | command-prompt -I "#S" { rename-session "%%" } | inherited |
Files & buffers
No matches.
| Key | Command | Source |
| - | delete-buffer | inherited |
Copy mode & buffers
No matches.
| Key | Command | Source |
| C-l | send-keys C-l | inherited |
| PPage | copy-mode -u | inherited |
| [ | copy-mode | inherited |
| ] | paste-buffer -p | inherited |
| d | run-shell "tmux send-keys -t vpn C-c 2>/dev/null; sleep 0.3; tmux send-keys -t vpn C-c 2>/dev/null; tmux detach-client" | declared |
Reload & session persistence
No matches.
| Key | Command | Source |
| C-r | run-shell ~/.tmux/plugins/tmux-resurrect/scripts/restore.sh | declared |
| C-s | run-shell ~/.tmux/plugins/tmux-resurrect/scripts/save.sh | inherited |
| r | source-file ~/.tmux.conf \; display-message "🔄 tmux config reloaded!" | declared |
Command prompt
No matches.
| Key | Command | Source |
| , | command-prompt -I "#W" { rename-window "%%" } | inherited |
| / | command-prompt -k -p key { list-keys -1N "%%" } | inherited |
| : | command-prompt | inherited |
| ? | list-keys -N | inherited |
| C | customize-mode -Z | inherited |
| f | command-prompt { find-window -Z "%%" } | inherited |
Detach & buffers
No matches.
| Key | Command | Source |
| & | confirm-before -p "kill-window #W? (y/n)" kill-window | inherited |
| = | choose-buffer -Z | inherited |
| \# | list-buffers | inherited |
| x | confirm-before -p "kill-pane #P? (y/n)" kill-pane | inherited |
Other
No matches.
| Key | Command | Source |
| C-b | run-shell "workmux sidebar" | declared |
| D | choose-client -Z | declared |
| DC | refresh-client -c | inherited |
| E | run-shell "\"~/.tmux/plugins/tmux-agent-sidebar/bin/tmux-agent-sidebar\" toggle-all" | inherited |
| I | run-shell ~/.tmux/plugins/tpm/bindings/install_plugins | inherited |
| M-u | run-shell ~/.tmux/plugins/tpm/bindings/clean_plugins | inherited |
| R | refresh-client \; display-message "🔄 Display refreshed!" | declared |
| U | run-shell ~/.tmux/plugins/tpm/bindings/update_plugins | inherited |
| \~ | show-messages | inherited |
| c | new-window | inherited |
| e | run-shell "\"~/.tmux/plugins/tmux-agent-sidebar/bin/tmux-agent-sidebar\" toggle \"#{window_id}\" \"#{pane_current_path}\"" | inherited |
| i | display-message | inherited |
| q | display-panes | inherited |
| t | clock-mode | inherited |
Layer 3 — Terminals
Three terminals are configured: Ghostty, Alacritty and WezTerm. Ghostty is
the default (per ghostty/config) and the only one with multiplexer-aware
bindings.
Ghostty
Multiplexer pass-through
No matches.
| Key | Value |
| cmd+b | text:\x01\x7a |
| cmd+s | text:\x01\x73 |
Clipboard
No matches.
| Key | Value |
| super+c | copy_to_clipboard |
| super+v | paste_from_clipboard |
Alacritty
WezTerm
wezterm/.wezterm.lua sets fonts, theme and
performance options and defines no keybindings — WezTerm's own
defaults apply unchanged.
Layer 4 — Editor (Neovim)
LazyVim-based, defined across nvim/lua/. Mappings come in
three forms: vim.keymap.set and map() calls in
config/customize.lua, vim.keymap.set calls in plugin specs, and
table-literal key lists.
Files & buffers
No matches.
| Key | Action | Mode |
| <S-Tab> | Previous buffer | n |
| <Tab> | Next buffer | n |
Clipboard
No matches.
| Key | Action | Mode |
| SPACEp | Paste without replacing the default register | n, v |
Edit
No matches.
| Key | Action | Mode |
| D | Delete to the vois register. | n |
Jump & project
No matches.
| Key | Action | Mode |
| SPACEjc | Jump to component | n |
| SPACEjs | Jump to styles | n |
| SPACEjt | Jump to template | n |
Folds
No matches.
| Key | Action | Mode |
| zM | Close All Folds | n |
| zR | Open All Folds | n |
| zm | Close Folds With Level | n |
| zr | Open Folds Except Kinds | n |
LSP & diagnostics
No matches.
| Key | Action | Mode |
| SPACEvr | Rename variable (LSP) | n |
AI agents
No matches.
| Key | Action | Mode |
| <C-a> | Ask OpenCode… | n, x |
| <C-x> | Select OpenCode… | n, x |
Other
No matches.
| Key | Action | Mode |
| <C-j> | <Esc>o | i |
| <Esc> | Exit terminal mode | t |
| <S-C-d> | inline function | n |
| <S-C-u> | inline function | n |
| <Space> | - | n |
| <c-h> | - | plugin |
| <c-j> | - | plugin |
| <c-k> | - | plugin |
| <c-l> | - | plugin |
| F | inline function | n |
| SPACEa | - | plugin |
| SPACEa | <cmd>lua require | n, v |
| SPACEaa | - | plugin |
| SPACEab | - | plugin |
| SPACEac | - | plugin |
| SPACEad | - | plugin |
| SPACEas | - | plugin |
| SPACEb | <cmd>lua require | n, v |
| SPACEcn | <cmd>lua require | n, v |
| SPACEcp | <cmd>lua require | n, v |
| SPACEd | <cmd>lua require | n, v |
| SPACEfd | <cmd>lua require | n, v |
| SPACEff | <cmd>lua require | n, v |
| SPACEfs | inline function | n, v, i |
| SPACEoa | - | plugin |
| SPACEpr | <cmd>lua require | n, v |
| SPACEsp | <cmd>lua require | n, v |
| SPACEt | <cmd>lua require | n, v |
| SPACEup | inline function | n |
| go | inline function | n, x |
| goo | inline function | n |
| hs | Horizontal Split | n |
| te | :tabedit") | n |
| vs | Verticle Split | n |
| zM | require | n |
| zR | require | n |
Layer 5 — Shell (zsh)
Other
No matches.
| Key | Widget |
| ^F | _directory_suggestion_widget |
The widget itself — a fzf-backed directory picker —
is defined in zsh/.local/share/zsh/functions.zsh.
Gotchas
- Cmd+B in Ghostty depends on a tmux default, not on this
repo. It sends the raw sequence
\x01\x7a, i.e. prefix then
z. z is never bound in
tmux/.tmux.conf, so it resolves to tmux's built-in default
resize-pane -Z — “toggle zoom state of the current pane”.
That works today, but it is the one key here that depends on tmux's defaults rather than
on anything in this repo: rebind z or upgrade tmux and
Cmd+B stops zooming with no error in Ghostty's config to explain
why. It is the reason prefix+z is marked inherited in the tmux
table.
- Cmd+S is likewise a raw sequence, not a save.
\x01\x73 is prefix then s, which tmux binds to
split-window -v. So Cmd+S splits panes, while
Cmd+Q (not bound here) would be the actual save.
- tmux's split flags read backwards from what they produce.
split-window -h — used by prefix+v and
prefix+% — puts panes side by side.
split-window -v — used by prefix+s and
prefix+' — stacks them. The flag names
the direction of the split operation, not the arrangement you end up looking at.
- Neovim's Space is the leader, and is also remapped to nothing.
nvim/lua/config/customize.lua sets vim.g.mapleader = " " and
maps <Space> to an empty right-hand side, so a bare Space is the
leader prefix rather than an insert-mode space.
- The
prefix+Ctrl+r yazi popup is dead.
tmux/.tmux.conf binds C-r to a yazi popup at
line 133, but the same file loads tpm at line 274, and tmux-resurrect binds C-r
to its restore script when it loads — after the config's own binding. The
plugin wins, so prefix+Ctrl+r restores a session
rather than opening a file picker, and yazi is not reachable from any binding.
tmux -f ~/.tmux.conf list-keys -T prefix shows the effective binding, which
is how this was found; the config file alone still claims yazi. Rebinding C-r
after the tpm line, or moving yazi to an unbound key, would fix it — left alone here
because this repo only documents its configuration.
- Two of the six sources are single-binding files. Alacritty and zsh
each declare exactly one binding. Their tables being this short is accurate, not a
parsing failure — the generator skips and warns rather than emitting a truncated
table if a source ever becomes unreadable.
Appendix — inherited keymaps
The tools below are reachable from the bindings above (lazygit and yazi via tmux popups,
fzf inside the zsh widget) but define no keybindings in this repo.
Their keys come from the tools' own defaults, so they’re documented upstream rather
than restated here — restating them here would risk claiming bindings this repo
doesn’t actually control.