Skip to content


Since: Nightly Builds Only

The functionality described in this section requires a nightly build of wezterm. You can obtain a nightly build by following the instructions from the Download section.

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