WezTerm — GPU-Accelerated Terminal Emulator and Multiplexer

What it is

WezTerm is a GPU-accelerated cross-platform terminal emulator and multiplexer written in Rust. It is configured entirely in Lua, providing programmable control over appearance, keybindings, and behavior. Built-in features include tabs, splits, SSH multiplexing, image display (iTerm2 and Kitty protocols), ligature support, and a rich set of escape sequences.

This tool is for developers and power users who want a fast, highly configurable terminal that replaces both a terminal emulator and a multiplexer like tmux.

How it saves time or tokens

WezTerm combines the terminal emulator and multiplexer into one application, eliminating the need to run tmux or screen inside another terminal. Lua configuration allows dynamic behavior: change themes based on time of day, adjust fonts per SSH host, or create custom status bars. GPU acceleration means scrolling through large log files stays smooth.

How to use

1. Download WezTerm for your platform.
2. Create a ~/.wezterm.lua configuration file.
3. Customize keybindings, appearance, and behavior in Lua.
4. Use built-in multiplexer features instead of tmux.

# Install on macOS
brew install --cask wezterm

# Install on Linux
flatpak install flathub org.wezfurlong.wezterm

Example

A ~/.wezterm.lua configuration:

local wezterm = require 'wezterm'
local config = wezterm.config_builder()

-- Appearance
config.color_scheme = 'Catppuccin Mocha'
config.font = wezterm.font('JetBrains Mono', { weight = 'Medium' })
config.font_size = 14.0
config.window_background_opacity = 0.95

-- Tab bar
config.use_fancy_tab_bar = false
config.tab_bar_at_bottom = true

-- Key bindings for splits
config.keys = {
  { key = 'd', mods = 'CMD', action = wezterm.action.SplitHorizontal { domain = 'CurrentPaneDomain' } },
  { key = 'd', mods = 'CMD|SHIFT', action = wezterm.action.SplitVertical { domain = 'CurrentPaneDomain' } },
}

return config

Related on TokRepo

• Automation tools — Terminal and workflow automation
• DevOps tools — Tools for terminal-based workflows

Common pitfalls

• Lua configuration has a learning curve if you are used to TOML or YAML config files. The flexibility comes at the cost of verbosity.
• GPU acceleration requires compatible graphics drivers. Some older systems or VM environments may fall back to software rendering.
• WezTerm's built-in multiplexer is not a drop-in replacement for tmux. Session persistence across reboots requires WezTerm's mux server.
• Image display protocols vary. Not all terminal applications support the same image protocols that WezTerm implements.
• WezTerm's binary size is larger than minimal terminals like Alacritty due to the built-in multiplexer and Lua runtime.
• Review the official documentation before deploying to production to ensure compatibility with your specific environment and requirements.