name: wezterm description: "Control WezTerm terminal emulator via CLI. Manage panes, tabs, workspaces, and execute commands in running terminals."

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 <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 <pane-id> "ls -la\n"

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