Skip to content

wezterm cli move-pane-to-new-tab

Since: Version 20220624-141144-bd1b7c5d

The functionality described in this section requires version 20220624-141144-bd1b7c5d of wezterm, or a more recent version.

Run wezterm cli move-pane-to-new-tab --help to see more help

Allows moving a pane into a new tab either in the same window or in a new window.

The default action is to move the current pane into a new tab in the same window. The following arguments modify the behavior:

  • --new-window - Create tab in a new window
  • --window-id WINDOW_ID - Create the new tab in the specified window id rather than the current window.
  • --workspace WORKSPACE - When using --new-window, use WORKSPACE as the name of the workspace for the newly created window rather than the default workspace name "default".
  • --pane-id - Specifies which pane to move. See also Targeting Panes.

See also: pane:move_to_new_window(), pane:move_to_new_tab().


Move a pane into a new tab

Usage: wezterm cli move-pane-to-new-tab [OPTIONS]

      --pane-id <PANE_ID>      Specify the pane that should be moved. The
                               default is to use the current pane based on the
                               environment variable WEZTERM_PANE
      --window-id <WINDOW_ID>  Specify the window into which the new tab will be
                               created. If omitted, the window associated with
                               the current pane is used
      --new-window             Create tab in a new window, rather than the
                               window currently containing the pane
      --workspace <WORKSPACE>  If creating a new window, override the default
                               workspace name with the provided name.  The
                               default name is "default"
  -h, --help                   Print help