Skip to content


Since: Version 20230320-124340-559cb7b0

The functionality described in this section requires version 20230320-124340-559cb7b0 of wezterm, or a more recent version.

Activates the nth GUI window, zero-based.

Performing this action is equivalent to executing this lua code fragment:

wezterm.gui.gui_windows()[n + 1]:focus()

Here's an example of setting up hotkeys to activate specific windows:

local wezterm = require 'wezterm'
local act = wezterm.action
local config = {}

config.keys = {}
for i = 1, 8 do
  -- CMD+ALT + number to activate that window
  table.insert(config.keys, {
    key = tostring(i),
    mods = 'CMD|ALT',
    action = act.ActivateWindow(i - 1),

return config

See also ActivateWindowRelative, ActivateWindowRelativeNoWrap.