Wezterm

THE EXACT PROMPT — Multi-Pane Workflow

Create Development Layout

# Start with htop on right, logs below
wezterm cli split-pane --right -- htop
wezterm cli split-pane --bottom -- tail -f /var/log/syslog

# Send command to specific pane
wezterm cli send-text --pane-id 0 "cd ~/project && npm start\n"

Scripted Layout

#!/bin/bash
# Create 3-pane layout: main | htop
#                       logs |
wezterm cli split-pane --right -- htop
wezterm cli activate-pane-direction left
wezterm cli split-pane --bottom -- tail -f app.log
wezterm cli activate-pane-direction up

Configuration

Config file: ~/.config/wezterm/wezterm.lua

# Show key bindings
wezterm show-keys

Multiplexer Domains

# List unique domains
wezterm cli list --format json | jq '.[].domain_name' | sort -u

# Spawn in SSH domain
wezterm cli spawn --domain-name SSH:myserver

# Connect to mux server
wezterm connect unix

Persistent Remote Sessions

The Problem: Mac sleeps, reboots, or loses power → all terminal sessions vanish.

The Solution: wezterm-mux-server on each remote via systemd. Sessions persist on the server.

# Remote server setup (one-time)
mkdir -p ~/.config/systemd/user

cat > ~/.config/systemd/user/wezterm-mux-server.service << 'EOF'
[Unit]
Description=WezTerm Mux Server
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/wezterm-mux-server --daemonize=false
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target
EOF

systemctl --user daemon-reload
systemctl --user enable --now wezterm-mux-server
sudo loginctl enable-linger $USER

-- Local config: SSH domain with mux
config.ssh_domains = {
  {
    name = 'dev-server',
    remote_address = '10.20.30.1',
    username = 'ubuntu',
    multiplexing = 'WezTerm',  -- Key setting
  },
}

See PERSISTENT-SESSIONS.md for full setup with domain colors and smart startup.

CLI Location

macOS:

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

Or add to PATH for easier access.

References