Skip to content

A modern terminal with a built-in multiplexer: close it and your sessions keep running. Run shells and tons of AI agents across your machines, then pick them up from desktop, browser, TUI and more. Written in Rust with no UI framework: interface drawn straight on the GPU. No Electron, GPUI or webview.

1.2 KB
Raw Blame

SendKey

{{since('20211204-082213-a66c61ee9')}}

Send the specified key press to the current pane. This is useful to rebind the effect of a key combination.

Note that this rebinding effect only applies to the input that is about to be sent to the pane; it doesn't get re-evaluated against the key assignments you've configured in wezterm again.

For example, macOS users often prefer to rebind Option+LeftArrow and Option+RightArrow to match the behavior of Terminal.app, where those key sequences are remapped to ALT-b and ALT-f which generally causes the the cursor to move backwards or forwards by one word in most common unix shells and applications.

The following configuration achieves that same effect:

local act = wezterm.action

config.keys = {
  -- Rebind OPT-Left, OPT-Right as ALT-b, ALT-f respectively to match Terminal.app behavior
  {
    key = 'LeftArrow',
    mods = 'OPT',
    action = act.SendKey {
      key = 'b',
      mods = 'ALT',
    },
  },
  {
    key = 'RightArrow',
    mods = 'OPT',
    action = act.SendKey { key = 'f', mods = 'ALT' },
  },
}

See also Multiple for combining multiple actions in a single press.