Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

wezterm-keybindings

verified

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 GitHub

Marketplace

functional-claude

nthplusio/functional-claude

Plugin

wezterm-dev

Repository
Verified Org

nthplusio/functional-claude

plugins/wezterm-dev/skills/wezterm-keybindings/SKILL.md

Last Verified

February 2, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/nthplusio/functional-claude/blob/main/plugins/wezterm-dev/skills/wezterm-keybindings/SKILL.md -a claude-code --skill wezterm-keybindings

Installation paths:

Claude
.claude/skills/wezterm-keybindings/
Powered by add-skill CLI

Instructions

# 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

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
3524 chars