wezterm(1)
A GPU-accelerated cross-platform terminal emulator written in Rust with modern features like multiplexing and ligature support.
Synopsis
wezterm [OPTIONS] [COMMAND]Description
Wezterm is a powerful terminal emulator that combines speed, features, and extensibility. It supports true color, Unicode, font ligatures, and uses the GPU for rendering. It includes built-in multiplexing capabilities similar to tmux, allowing you to split panes and manage multiple tabs directly within the terminal.
Configuration is done via Lua scripts, giving you full programmatic control over behavior, keybindings, colors, and appearance. Wezterm works on Linux, macOS, and Windows with consistent behavior across platforms.
Common options
| Flag | What it does |
|---|---|
-n, --new-window | Spawn a new window instead of reusing an existing one |
-h, --help | Show help message and exit |
--version | Show version information |
--config-file FILE | Specify alternative configuration file path |
--class CLASS | Set the X11 window class name |
--position X,Y | Set initial window position |
-e, --command CMD | Execute specified command instead of shell |
--domain DOMAIN | Connect to named multiplexing domain |
Examples
Launch wezterm with default configuration and your shell
weztermOpen wezterm in a new window instead of a new tab in existing window
wezterm -nOpen wezterm and immediately launch nvim with the specified file
wezterm -e nvim myfile.txtSplit the current pane horizontally (CLI control of multiplexing)
wezterm cli split-paneOpen a serial port connection (Windows/Linux example)
wezterm serial COM1Connect to a Unix domain socket multiplexing session
wezterm connect unix