---

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

Copy/Applications/WezTerm.app/Contents/MacOS/wezterm

Or add to PATH for easier access.

Listing and Connecting

List all WezTerm panes:

Copywezterm cli list

List in JSON format:

Copywezterm cli list --format json

List clients (GUI windows):

Copywezterm cli list-clients

Pane Management

Get current pane ID:

Copywezterm cli get-pane-direction

Split pane horizontally (new pane to right):

Copywezterm cli split-pane --right

Split pane vertically (new pane below):

Copywezterm cli split-pane --bottom

Split with specific command:

Copywezterm cli split-pane --right -- htop

Move focus between panes:

Copywezterm 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:

Copywezterm cli activate-pane --pane-id <pane-id>

Tab Management

Create new tab:

Copywezterm cli spawn

Create tab with command:

Copywezterm cli spawn -- vim

Create tab in specific domain:

Copywezterm cli spawn --domain-name SSH:server

Activate tab by index:

Copywezterm cli activate-tab --tab-index 0

Activate tab relative:

Copywezterm 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:

Copywezterm cli send-text --pane-id <pane-id> "ls -la\n"

Send text to current pane:

Copywezterm cli send-text "echo hello\n"

Workspaces

List workspaces:

Copywezterm cli list --format json | jq '.[].workspace' | sort -u

Zoom

Toggle pane zoom:

Copywezterm cli zoom-pane --toggle

Zoom pane:

Copywezterm cli zoom-pane --zoom

Unzoom:

Copywezterm cli zoom-pane --unzoom

Multiplexer Domains

List domains (local, SSH, etc.):

Copywezterm cli list --format json | jq '.[].domain_name' | sort -u

Connect to SSH domain:

Copywezterm cli spawn --domain-name SSH:myserver

Configuration

Config file:

Copy~/.config/wezterm/wezterm.lua

Show effective config:

Copywezterm show-keys

Launching

Start new window:

Copywezterm start

Start with command:

Copywezterm start -- htop

Start in directory:

Copywezterm start --cwd /path/to/dir

Connect to running mux server:

Copywezterm connect unix