wezterm

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

WezTerm Skill

WezTerm 使用技巧

Use the

wezterm

CLI to control and interact with WezTerm terminal instances.

使用

wezterm

CLI控制并与WezTerm终端实例进行交互。

CLI Location

CLI 位置

bash

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

Or add to PATH for easier access.

bash

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

或者将其添加到PATH中以方便访问。

Listing and Connecting

列出实例与连接

List all WezTerm panes:

bash

wezterm cli list

List in JSON format:

bash

wezterm cli list --format json

List clients (GUI windows):

bash

wezterm cli list-clients

列出所有WezTerm面板：

bash

wezterm cli list

以JSON格式列出：

bash

wezterm cli list --format json

列出客户端（GUI窗口）：

bash

wezterm cli list-clients

Pane Management

面板管理

Get current pane ID:

bash

wezterm cli get-pane-direction

Split pane horizontally (new pane to right):

bash

wezterm cli split-pane --right

Split pane vertically (new pane below):

bash

wezterm cli split-pane --bottom

Split with specific command:

bash

wezterm cli split-pane --right -- htop

Move focus between panes:

bash

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:

bash

wezterm cli activate-pane --pane-id <pane-id>

获取当前面板ID：

bash

wezterm cli get-pane-direction

水平拆分面板（新面板在右侧）：

bash

wezterm cli split-pane --right

垂直拆分面板（新面板在下方）：

bash

wezterm cli split-pane --bottom

使用指定命令拆分：

bash

wezterm cli split-pane --right -- htop

在面板间切换焦点：

bash

wezterm cli activate-pane-direction up
wezterm cli activate-pane-direction down
wezterm cli activate-pane-direction left
wezterm cli activate-pane-direction right

通过ID激活指定面板：

bash

wezterm cli activate-pane --pane-id <pane-id>

Tab Management

标签页管理

Create new tab:

bash

wezterm cli spawn

Create tab with command:

bash

wezterm cli spawn -- vim

Create tab in specific domain:

bash

wezterm cli spawn --domain-name SSH:server

Activate tab by index:

bash

wezterm cli activate-tab --tab-index 0

Activate tab relative:

bash

wezterm cli activate-tab --tab-relative 1   # next tab
wezterm cli activate-tab --tab-relative -1  # previous tab

新建标签页：

bash

wezterm cli spawn

使用指定命令新建标签页：

bash

wezterm cli spawn -- vim

在指定域中新建标签页：

bash

wezterm cli spawn --domain-name SSH:server

通过索引激活标签页：

bash

wezterm cli activate-tab --tab-index 0

相对切换标签页：

bash

wezterm cli activate-tab --tab-relative 1   # 下一个标签页
wezterm cli activate-tab --tab-relative -1  # 上一个标签页

Sending Commands to Panes

向面板发送命令

Send text to a pane:

bash

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

Send text to current pane:

bash

wezterm cli send-text "echo hello\n"

向指定面板发送文本：

bash

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

向当前面板发送文本：

bash

wezterm cli send-text "echo hello\n"

Workspaces

工作区

List workspaces:

bash

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

列出工作区：

bash

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

Zoom

缩放

Toggle pane zoom:

bash

wezterm cli zoom-pane --toggle

Zoom pane:

bash

wezterm cli zoom-pane --zoom

Unzoom:

bash

wezterm cli zoom-pane --unzoom

切换面板缩放状态：

bash

wezterm cli zoom-pane --toggle

放大面板：

bash

wezterm cli zoom-pane --zoom

取消放大：

bash

wezterm cli zoom-pane --unzoom

Multiplexer Domains

多路复用器域

List domains (local, SSH, etc.):

bash

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

Connect to SSH domain:

bash

wezterm cli spawn --domain-name SSH:myserver

列出域（本地、SSH等）：

bash

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

连接到SSH域：

bash

wezterm cli spawn --domain-name SSH:myserver

Configuration

配置

Config file:

~/.config/wezterm/wezterm.lua

Show effective config:

bash

wezterm show-keys

配置文件：

~/.config/wezterm/wezterm.lua

查看生效的配置：

bash

wezterm show-keys

Launching

启动

Start new window:

bash

wezterm start

Start with command:

bash

wezterm start -- htop

Start in directory:

bash

wezterm start --cwd /path/to/dir

Connect to running mux server:

bash

wezterm connect unix

启动新窗口：

bash

wezterm start

使用指定命令启动：

bash

wezterm start -- htop

在指定目录启动：

bash

wezterm start --cwd /path/to/dir

连接到运行中的多路复用服务器：

bash

wezterm connect unix