This skill should be used when the user asks about "leader key", "prefix key", "tmux-style", "keybindings", "wezterm keys", "ctrl+a wezterm", "pane splitting", "vim-style navigation", "remote tmux", "ssh tmux", "wezterm tmux", "modifier key", "keybinding conflict", or mentions WezTerm keyboard shortcuts and pane management.
View on GitHubplugins/wezterm-dev/skills/wezterm-keybindings/SKILL.md
February 2, 2026
Select agents to install to:
npx add-skill https://github.com/nthplusio/functional-claude/blob/main/plugins/wezterm-dev/skills/wezterm-keybindings/SKILL.md -a claude-code --skill wezterm-keybindingsInstallation paths:
.claude/skills/wezterm-keybindings/# WezTerm Keybindings
Configure tmux-style keybindings for WezTerm with leader key support.
## Leader Key Setup
The leader key acts as a prefix (like tmux's Ctrl+B or Ctrl+A):
```lua
config.leader = { key = 'a', mods = 'CTRL', timeout_milliseconds = 1000 }
```
After pressing Ctrl+A, you have 1 second to press the next key.
## Essential Keybindings
| Keys | Action |
|------|--------|
| `Ctrl+A, -` | Split horizontal (pane below) |
| `Ctrl+A, \` | Split vertical (pane right) |
| `Ctrl+A, h/j/k/l` | Navigate panes (vim-style) |
| `Ctrl+A, x` | Close current pane |
| `Ctrl+A, z` | Toggle pane zoom |
| `Ctrl+A, [` | Enter copy mode |
| `Ctrl+A, c` | Launch Claude Code |
## Configuration
```lua
config.keys = {
-- Pane splits
{ key = '-', mods = 'LEADER', action = wezterm.action.SplitVertical { domain = 'CurrentPaneDomain' } },
{ key = '\\', mods = 'LEADER', action = wezterm.action.SplitHorizontal { domain = 'CurrentPaneDomain' } },
-- Pane navigation (vim-style)
{ key = 'h', mods = 'LEADER', action = wezterm.action.ActivatePaneDirection 'Left' },
{ key = 'j', mods = 'LEADER', action = wezterm.action.ActivatePaneDirection 'Down' },
{ key = 'k', mods = 'LEADER', action = wezterm.action.ActivatePaneDirection 'Up' },
{ key = 'l', mods = 'LEADER', action = wezterm.action.ActivatePaneDirection 'Right' },
-- Pane management
{ key = 'x', mods = 'LEADER', action = wezterm.action.CloseCurrentPane { confirm = true } },
{ key = 'z', mods = 'LEADER', action = wezterm.action.TogglePaneZoomState },
{ key = '[', mods = 'LEADER', action = wezterm.action.ActivateCopyMode },
-- Quick launcher for Claude Code
{ key = 'c', mods = 'LEADER', action = wezterm.action.SpawnCommandInNewTab { args = { 'claude' } } },
}
```
## Pane Resize Bindings
```lua
-- Add these to config.keys
{ key = 'H', mods = 'LEADER', action = wezterm.action.AdjustPaneSize { 'Left', 5 } },
{ key = 'J', mods = 'LEADER', action = wezterm.action.AdjustPaneSi