Keyboard shortcuts¶

Choose the layer where the shortcut runs. Alacritty, the terminal application, sends many macOS-style shortcuts directly to tmux; fish adds command-line bindings; tmux commands use Ctrl + A as their prefix.

macOS system shortcuts¶

These mappings are applied by the system_defaults Ansible role.

Shortcut	Action
`Cmd`+`G`	Open Spotlight
`Cmd`+`Space`	Select the next input source

The default shortcut for selecting the previous input source is disabled so it does not conflict with the configured next-source binding.

Alacritty and tmux¶

These shortcuts work from Alacritty without first entering the tmux prefix.

Windows and sessions¶

Shortcut	Action
`Cmd`+`N`	Open a new Alacritty window
`Cmd`+`T`	Create a tmux window in the current directory
`Cmd`+`Shift`+`R`	Rename the tmux session
`Cmd`+`W`	Kill the current tmux window
`Cmd`+`X`	Kill the current tmux pane

Shortcut	Action
`Ctrl`+`Tab`	Select the next tmux window
`Ctrl`+`Shift`+`Tab`	Select the previous tmux window
`Cmd`+`1` … `Cmd`+`9`	Select tmux window 1–9
`Cmd`+`F`	Enter copy mode and search forward
`Cmd`+`0`	Reset the Alacritty font size

fish shell¶

These bindings act on the current fish command line.

Shortcut	Action
`Alt`+`S`	Prepend `sudo` unless the command line already starts with it
`Ctrl`+`G`	Open the project chooser powered by fzf

Some additional character bindings are keyboard-layout dependent. See the source file for the exact mappings used by this configuration.

tmux prefix commands¶

Press Ctrl+A, release it, and then press the command key.

Create and arrange¶

Command	Action
`Ctrl`+`A` then `c`	Create a window in the current directory
`Ctrl`+`A` then `r`	Rename the current window
`Ctrl`+`A` then `R`	Rename the current session
`Ctrl`+`A` then `\\|`	Split the pane horizontally
`Ctrl`+`A` then `_`	Split the pane vertically
`Ctrl`+`A` then `+`	Toggle pane zoom

Move around¶

Command	Action
`Ctrl`+`A` then `h` / `j` / `k` / `l`	Move one pane left, down, up, or right
`Ctrl`+`A` then `[` / `]`	Select the previous / next pane
`Ctrl`+`A` then `{` / `}`	Select the previous / next window
`Ctrl`+`A` then `Tab`	Return to the most recently used window

Close and detach¶

Command	Action
`Ctrl`+`A` then `x`	Kill the current pane
`Ctrl`+`A` then `X`	Kill the current window
`Ctrl`+`A` then `Ctrl`+`X`	Confirm and kill every other window
`Ctrl`+`A` then `Q`	Confirm and kill the session
`Ctrl`+`A` then `d`	Detach this client
`Ctrl`+`A` then `D`	Detach other clients when present

Configuration and copy mode¶

Command	Action
`Ctrl`+`A` then `Ctrl`+`E`	Edit `tmux.conf`, then reload it
`Ctrl`+`A` then `Ctrl`+`R`	Reload `tmux.conf`
`Ctrl`+`S`	Enter copy mode without the prefix
`Ctrl`+`A` then `p`	Paste the latest tmux buffer
`Ctrl`+`A` then `Ctrl`+`P`	Choose a tmux buffer

Copy mode uses vi keys and supports the mouse wheel, Page Up and Page Down, and Option-based scrolling by line or half page.

Neovim additions¶

LazyVim provides most editor mappings. This repository adds only a small set:

Mode	Shortcut	Action
Normal	`o`	Create a blank line below without staying in Insert mode
Normal	`O`	Create a blank line above without staying in Insert mode
Normal	`<leader><leader>`	Clear search highlights
Visual	`>` / `<`	Indent while keeping the selection active

Source of truth¶

macOS shortcuts: config.yaml
Alacritty shortcuts: alacritty.toml.tmpl
fish shortcuts: binds.fish
tmux shortcuts: tmux.conf
Neovim additions: keymaps.lua