Skip to content


Since: Version 20220319-142410-0fcdea07

The functionality described in this section requires version 20220319-142410-0fcdea07 of wezterm, or a more recent version.

Returns the name of the active workspace.

This example demonstrates using the launcher menu to select and create workspaces, and how the workspace can be shown in the right status area.

local wezterm = require 'wezterm'

wezterm.on('update-right-status', function(window, pane)

return {
  keys = {
      key = '9',
      mods = 'ALT',
      action = wezterm.action.ShowLauncherArgs { flags = 'FUZZY|WORKSPACES' },