wezterm-keybindings

Configure WezTerm keybindings for tmux-style pane management and leader-key workflows.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/nthplusio/functional-claude --skill wezterm-keybindings
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wezterm-keybindings
Source: https://github.com/nthplusio/functional-claude/tree/main/plugins/wezterm-dev/skills/wezterm-keybindings
Command: npx skills add https://github.com/nthplusio/functional-claude --skill wezterm-keybindings

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the challenge of configuring intuitive, tmux-style keybindings in WezTerm, enabling fast pane management, leader-key workflows, and vim-like navigation.

Core Features & Use Cases

  • Leader-key based pane navigation: Use a designated leader key to quickly split, navigate, and manage panes.
  • Tmux-like navigation: Vim-style pane movement with h/j/k/l and pane focus shortcuts.
  • Quick access & launches: Bind a leader sequence to launch Claude Code or other commands from the terminal.

Quick Start

Add the following Lua snippet to your WezTerm config and reload: config.keys = { { key = '-', mods = 'LEADER', action = wezterm.action.SplitVertical { domain = 'CurrentPaneDomain' } }, { key = '\', mods = 'LEADER', action = wezterm.action.SplitHorizontal { domain = 'CurrentPaneDomain' } }, { 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' }, { 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 }, { key = 'c', mods = 'LEADER', action = wezterm.action.SpawnCommandInNewTab { args = { 'claude' } } }, }

Frequently Asked Questions about wezterm-keybindings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up tmux-style pane management in WezTerm?

You can configure tmux-style pane management in WezTerm by adding Lua snippets to your config that map a leader key to actions like SplitVertical, SplitHorizontal, and ActivatePaneDirection. This enables fast splitting and navigation.

How do I use vim-style navigation to move between WezTerm panes?

Vim-style navigation in WezTerm is configured by binding the h, j, k, and l keys to the LEADER modifier. This maps the keys to the ActivatePaneDirection action, allowing you to move left, down, up, and right between panes.

Can I launch Claude Code directly from a WezTerm leader key workflow?

Yes, you can launch Claude Code from a WezTerm leader key workflow by binding the 'c' key with the LEADER modifier to the SpawnCommandInNewTab action, passing 'claude' as an argument to execute the command quickly.

What is the best way to close or zoom a specific pane in WezTerm using Lua?

The best way to close or zoom a pane in WezTerm using Lua is to bind the 'x' key to CloseCurrentPane and the 'z' key to TogglePaneZoomState under the LEADER modifier, replicating tmux pane controls.

Does WezTerm support a leader key for copy mode similar to tmux?

Yes, WezTerm supports a leader key for copy mode similar to tmux. You can bind the '[' key with the LEADER modifier to the ActivateCopyMode action in your Lua configuration to enter copy mode quickly.

Why use Lua for WezTerm terminal configuration instead of static JSON?

Using Lua for WezTerm terminal configuration allows you to define dynamic keybindings and leader-key workflows programmatically. This approach supports complex pane management logic and vim-like navigation that static formats cannot easily handle.