WezTerm Skill
Use the wezterm CLI to control and interact with WezTerm terminal instances.
CLI Location /Applications/WezTerm.app/Contents/MacOS/wezterm
Or add to PATH for easier access.
Listing and Connecting
List all WezTerm panes:
wezterm cli list
List in JSON format:
wezterm cli list --format json
List clients (GUI windows):
wezterm cli list-clients
Pane Management
Get current pane ID:
wezterm cli get-pane-direction
Split pane horizontally (new pane to right):
wezterm cli split-pane --right
Split pane vertically (new pane below):
wezterm cli split-pane --bottom
Split with specific command:
wezterm cli split-pane --right -- htop
Move focus between panes:
wezterm cli activate-pane-direction up wezterm cli activate-pane-direction down wezterm cli activate-pane-direction left wezterm cli activate-pane-direction right
Activate specific pane by ID:
wezterm cli activate-pane --pane-id
Tab Management
Create new tab:
wezterm cli spawn
Create tab with command:
wezterm cli spawn -- vim
Create tab in specific domain:
wezterm cli spawn --domain-name SSH:server
Activate tab by index:
wezterm cli activate-tab --tab-index 0
Activate tab relative:
wezterm cli activate-tab --tab-relative 1 # next tab wezterm cli activate-tab --tab-relative -1 # previous tab
Sending Commands to Panes
Send text to a pane:
wezterm cli send-text --pane-id
Send text to current pane:
wezterm cli send-text "echo hello\n"
Workspaces
List workspaces:
wezterm cli list --format json | jq '.[].workspace' | sort -u
Zoom
Toggle pane zoom:
wezterm cli zoom-pane --toggle
Zoom pane:
wezterm cli zoom-pane --zoom
Unzoom:
wezterm cli zoom-pane --unzoom
Multiplexer Domains
List domains (local, SSH, etc.):
wezterm cli list --format json | jq '.[].domain_name' | sort -u
Connect to SSH domain:
wezterm cli spawn --domain-name SSH:myserver
Configuration
Config file:
~/.config/wezterm/wezterm.lua
Show effective config:
wezterm show-keys
Launching
Start new window:
wezterm start
Start with command:
wezterm start -- htop
Start in directory:
wezterm start --cwd /path/to/dir
Connect to running mux server:
wezterm connect unix