__      __      _____                ___         
\ \    / /__ __|_   _|__ _ _ _ __   | __|_ _____ 
 \ \/\/ / -_)_ / | |/ -_) '_| '  \  | _|\ V / _ \
  \_/\_/\___/__| |_|\___|_| |_|_|_| |___|\_/\___/

A WezTerm fork enhanced specifically for Claude Code and its Agent Team feature. For upstream documentation and general WezTerm usage, see wezterm.org.

WezTerm Evo includes a full tmux CC (Control-Client) protocol server that lets Claude Code agents manage terminal panes natively using standard tmux commands — no actual tmux installation required.

• 44 tmux-compatible commands — split-window, send-keys, list-panes, select-layout, capture-pane, kill-pane, and many more
• 10 real-time notifications — pane focus changes, tab/window lifecycle events, layout changes, clipboard sync
• 36 format variables — pane_id, window_name, session_name, pane_current_path, etc.
• Tmux-compat shim binary (tmux-compat-shim/) — drop-in tmux executable so Claude agents use familiar tmux commands that route to WezTerm's CC server
• env shim for Windows (env-shim/) — emulates the Unix env command (KEY=VAL command args..., -i, -u) so cross-platform scripts just work

Optional 1-row colored headers at the top of each pane, useful for identifying agent panes in split layouts.

• Lua API: pane:set_header("label") / pane:get_header()
• Format callback: format-pane-header event (works like format-tab-title)
• Config colors: pane_header_active_fg_color, pane_header_active_bg_color, pane_header_inactive_fg_color, pane_header_inactive_bg_color

Switch between tmux-style layouts via Lua, CLI, or keybinding:

-- Keybinding
{ key = "1", mods = "ALT", action = act.SetTabLayout("even-horizontal") }

# CLI
wezterm cli set-tab-layout tiled

A floating percentage label appears centered on the divider while dragging splits, giving precise visual feedback on pane sizing. Controlled by show_split_size_indicator (default: true).

Everything from upstream WezTerm is preserved:

• GPU-accelerated rendering (wgpu)
• Lua-based configuration with hot-reload
• Built-in multiplexer and SSH domains
• Cross-platform: Windows, macOS, Linux
• Font shaping with HarfBuzz, ligature support
• Hyperlinks, image protocol support, and more

See the full feature list at wezterm.org.

git clone --recurse-submodules <this-repo>
cd wezterm
cargo build --release -p wezterm-gui

The tmux-compat-shim and env-shim binaries are built alongside:

cargo build --release -p tmux-compat-shim
cargo build --release -p env-shim

For upstream installation and platform-specific instructions, see the WezTerm installation docs.

1. Build and deploy — run build-and-deploy.ps1 (or manually place the tmux.exe and env.exe shim binaries in a tmux-compat/ subdirectory next to wezterm-gui.exe)
2. Enable tmux compat — add config.enable_tmux_compat = true to your .wezterm.lua
3. Launch WezTerm normally — no special shortcut or launcher needed

That's it. When enable_tmux_compat is enabled, every spawned shell automatically gets WEZTERM_TMUX_CC, TMUX, and PATH (with the tmux-compat/ shim directory prepended) configured by WezTerm. Claude Code agents will find the tmux shim on PATH and route commands through WezTerm's CC protocol server.

Fork-specific options in your .wezterm.lua:

local config = wezterm.config_builder()

-- Enable tmux CC protocol server for Claude Code agent teams
config.enable_tmux_compat = true

-- Per-pane header colors
config.pane_header_active_fg_color = "#ffffff"
config.pane_header_active_bg_color = "#336699"
config.pane_header_inactive_fg_color = "#aaaaaa"
config.pane_header_inactive_bg_color = "#333333"

-- Split drag indicator
config.show_split_size_indicator = true  -- default

💡 Tip: All standard WezTerm configuration options continue to work as documented at wezterm.org/config.

This project is built on top of wezterm/wezterm by Wez Furlong and contributors. All credit for the core terminal emulator, GPU rendering pipeline, multiplexer architecture, Lua config system, and cross-platform windowing goes to the upstream project.