wezterm-cli

WezTerm terminal control CLI

TLDR

Start new terminal

$ wezterm start

Connect to SSH

$ wezterm ssh [user@host]

Connect to serial port

$ wezterm serial [/dev/ttyUSB0]

Spawn new tab

$ wezterm cli spawn

Split pane

$ wezterm cli split-pane --right

List panes

$ wezterm cli list

wezterm is a GPU-accelerated terminal emulator and multiplexer. It supports tabs, split panes, SSH and serial connections, and image display (sixel, iTerm2 protocol). Configuration is done via Lua scripts, enabling dynamic behavior and complex key mappings.The `wezterm cli` subcommands control a running wezterm instance, allowing scripted pane management similar to tmux.

PARAMETERS

start

Start new terminal.

ssh destination

SSH connection.

serial port

Serial port connection.

cli spawn

Create new tab.

cli split-pane

Split current pane.

cli list

List windows/tabs/panes.

--config key=value

Override configuration.

CONFIGURATION

~/.wezterm.lua or ~/.config/wezterm/wezterm.lua

Lua-based configuration file for keybindings, fonts, colors, multiplexer settings, and SSH domains.

INSTALL

sudo pacman -S wezterm

sudo apk add wezterm-common

sudo zypper install wezterm

nix profile install nixpkgs#wezterm

CAVEATS

The `cli` subcommands require a running wezterm instance with the mux server enabled. Lua configuration errors prevent the terminal from starting; use `wezterm --config-file` to test alternate configs.