WezTerm Keyboard Shortcuts

Complete WezTerm keyboard shortcuts reference — 27 shortcuts across 3 categories. Quick reference cheat sheet for Windows & Mac.

Tabs & Windows (6)

ShortcutAction
Ctrl + Shift + TNew tab
Ctrl + Shift + WClose tab
Ctrl + TabNext tab
Ctrl + Shift + TabPrevious tab
Ctrl + Shift + NNew window
Alt + EnterToggle fullscreen

Panes (7)

ShortcutAction
Ctrl + Shift + Alt + "Split vertically
Ctrl + Shift + Alt + %Split horizontally
Ctrl + Shift + LeftFocus pane left
Ctrl + Shift + RightFocus pane right
Ctrl + Shift + UpFocus pane above
Ctrl + Shift + DownFocus pane below
Ctrl + Shift + ZZoom pane

Copy, Search & UI (14)

ShortcutAction
Ctrl + Shift + CCopy
Ctrl + Shift + VPaste
Ctrl + Shift + FSearch scrollback
Ctrl + Shift + XCopy mode
Ctrl + Shift + SpaceQuick select
Ctrl + Shift + KClear scrollback
Ctrl + Shift + PCommand palette
Shift + PageUpScroll page up
Shift + PageDownScroll page down
Ctrl + Shift + LDebug overlay
Ctrl + Shift + RReload configuration
Ctrl + =Increase font size
Ctrl + -Decrease font size
Ctrl + 0Reset font size
📄 View Printable Cheat Sheet — Download as PDF or print · 🧩 Combine with other tools

Related Shortcut Pages

kitty Alacritty tmux Zsh GNU Screen fzf

Search 13,500+ shortcuts across 269 platforms

Explore All Platforms Practice Shortcuts
🔧 Spotted an error or a missing shortcut? Suggest an edit on GitHub — every accepted fix goes live on this page, the API and the CLI.

Panes with a tmux accent

WezTerm's split chords look odd until you spot the homage: Ctrl + Shift + Alt + " splits vertically and Ctrl + Shift + Alt + % horizontally — the same " and % tmux uses, lifted into direct keybindings. Ctrl + Shift + Left/Right/Up/Down moves focus between panes, and Ctrl + Shift + Z zooms one pane to fill the tab, then restores the layout on a second press. Tabs behave conventionally: Ctrl + Shift + T new, Ctrl + Shift + W close, Ctrl + Tab cycles.

The selection tools are the underused gems. Ctrl + Shift + Space enters Quick Select, which overlays hint labels on URLs, file paths, and hashes in the scrollback — type a label and the item is copied, no mouse. Ctrl + Shift + X enters full copy mode for keyboard-driven selection, and Ctrl + Shift + F searches the scrollback.

A terminal you program

Configuration is a Lua file, ~/.wezterm.lua, and WezTerm hot-applies changes when it reloads — Ctrl + Shift + R forces it, and the Ctrl + Shift + L debug overlay shows errors and lets you evaluate Lua when a config change misbehaves. Ctrl + Shift + P opens the command palette for everything unbound, and font size rides on Ctrl + =, Ctrl + -, Ctrl + 0.

Frequently asked questions

Why are the split keys " and % of all things?

They mirror tmux, where " and % have split panes for decades. WezTerm adopts the same characters (behind the Ctrl + Shift + Alt modifier) so tmux muscle memory transfers — and if you dislike the stretch, both are one line to rebind in .wezterm.lua.

What does Quick Select actually select?

Things you usually mouse-drag: URLs, absolute and relative paths, git hashes, IPs. Ctrl + Shift + Space labels every match on screen with a short letter code; typing the code copies that item instantly. For arbitrary text, use copy mode (Ctrl + Shift + X) instead.

Where is the config, and do I need to restart after editing?

~/.wezterm.lua (created on first save — it does not exist by default). WezTerm watches it and applies most changes automatically; Ctrl + Shift + R reloads on demand, and the debug overlay on Ctrl + Shift + L is where syntax errors appear when a reload silently fails.

What is pane zoom for?

Ctrl + Shift + Z temporarily expands the focused pane to the whole tab — full width for reading logs or an editor — and the same key restores your split layout exactly as it was. It is a toggle, not a rearrangement.

How do I scroll and search history by keyboard?

Shift + PageUp / Shift + PageDown page through scrollback, Ctrl + Shift + F searches it, and Ctrl + Shift + K clears it. For selecting text while back there, enter copy mode with Ctrl + Shift + X and navigate with the arrow keys.

🤖 Ask AI about WezTerm shortcuts

Open your assistant with this page preloaded as the source — great for follow-up questions like "which of these work in other apps?"

ChatGPT Claude Perplexity Gemini Grok