Skip to content


Since: Version 20230712-072601-f4abf8fd

The functionality described in this section requires version 20230712-072601-f4abf8fd of wezterm, or a more recent version.

This event is emitted when the Command Palette is shown.

It's purpose is to enable you to add additional entries to the list of commands shown in the palette.

This hook is synchronous; calling asynchronous functions will not succeed.

The return value is a table listing the additional entries. Each element of the returned table may have the following fields:

  • brief - required: the brief description for the entry
  • doc - optional: a long description that may be shown after the entry, or that may be used in future versions of wezterm to provide more information about the command.
  • action - the action to take when the item is activated. Can be any key assignment action.
  • icon - optional Nerd Fonts glyph name to use for the icon for the entry. See wezterm.nerdfonts for a list of icon names.

Adding a Rename Tab entry to the palette

In this example, an entry is added for renaming tabs:

local wezterm = require 'wezterm'
local act = wezterm.action

local config = wezterm.config_builder()

wezterm.on('augment-command-palette', function(window, pane)
  return {
      brief = 'Rename tab',
      icon = 'md_rename_box',

      action = act.PromptInputLine {
        description = 'Enter new name for tab',
        action = wezterm.action_callback(function(window, pane, line)
          if line then

return config