WezTerm Keybindings & Features Guide

Config: ~/.wezterm.lua | Theme: Tokyo Night | Font: FiraCode Nerd Font 11pt

---

Tabs

Action	Keybinding
New tab	Ctrl+Shift+T
Previous tab	Ctrl+H
Next tab	Ctrl+L
Close tab/pane	Ctrl+Shift+W

Tab bar is at the bottom. Auto-hides when only one tab is open.

---

Pane Splitting

Action	Keybinding
Split side by side	Ctrl+Shift+D
Split top/bottom	Ctrl+Shift+R
Close pane	Ctrl+Shift+W (with confirmation)
Toggle pane zoom	Ctrl+Shift+Z
Rotate panes clockwise	Ctrl+Shift+O

Zoom temporarily maximizes the active pane. Press again to restore the layout. Inactive panes are dimmed (65% brightness).

---

Pane Navigation (Vim-style)

Action	Keybinding
Focus left	Ctrl+Shift+H
Focus down	Ctrl+Shift+J
Focus up	Ctrl+Shift+K
Focus right	Ctrl+Shift+L

---

Pane Resizing

Action	Keybinding
Grow left	Ctrl+Shift+Alt+Left
Grow right	Ctrl+Shift+Alt+Right
Grow up	Ctrl+Shift+Alt+Up
Grow down	Ctrl+Shift+Alt+Down

Each press resizes by 2 cells.

---

Workspaces

Workspaces are virtual desktops with their own tabs and panes.

Action	Keybinding
Create/switch workspace	Ctrl+Shift+N
Previous workspace	Ctrl+Shift+B
Next workspace	Ctrl+Shift+F

Current workspace shows in the status bar (purple) when not “default”.

---

Copy & Selection

Action	Keybinding
Enter copy mode (vim keys)	Ctrl+Shift+X
Quick select	Ctrl+Shift+S

Copy mode: h/j/k/l to move, v to select, y to yank, Esc to exit.

Quick select highlights git hashes, IPs, UUIDs, and file paths. Press a label key to copy.

---

Font & Display

Action	Keybinding
Increase font	Ctrl+=
Decrease font	Ctrl+-
Reset font size	Ctrl+0
Toggle ligatures	Ctrl+Shift+=

---

Launcher & Command Palette

Action	Keybinding
Command palette	Ctrl+Shift+P
Launcher	Ctrl+Shift+Space

Launcher includes: tabs, workspaces, and menu items (Bash, htop, git log, docker ps).

---

Mouse

Action	Mouse
Open link	Ctrl+Click
Paste	Right Click
Select word	Double-click
Select line	Triple-click

---

Hyperlinks

Auto-detected and clickable:

• URLs (https://...)
• File paths (/home/user/file.txt:10)
• GitHub refs (owner/repo#123)

---

Tab Title

Titles auto-detect in this priority order:

1. Manual title via tabtitle "name" or wezterm cli set-tab-title "name"
2. Worktree name when inside .claude/worktrees/
3. Process + directory (default)

tabtitle "my project"   # set custom title
tabtitle ""             # clear, back to auto-detect

---

Status Bar (bottom right)

Shows: folder | hostname (SSH only) | workspace (if not default) | clock

---

Tips

• Config is live — changes to ~/.wezterm.lua apply automatically
• Window opacity is 95% with subtle gradient background
• Visual bell flashes cursor instead of playing sound
• Scrollback buffer is 10,000 lines
• Rotate panes (Ctrl+Shift+O) to swap pane contents between positions