wezterm cli split-pane

Run wezterm cli split-pane --help to see more help

Split the current pane. Outputs the pane-id for the newly created pane on success.

This command will create a split in the current pane and spawn a command into it. This splits the pane and creates a new one at the bottom running the default command:

$ wezterm cli split-pane
2

You may spawn an alternative program by passing the argument list; it is recommended that you use -- to denote the end of the arguments being passed to wezterm cli split-pane so that any parameters you may wish to pass to the program are not confused with parameters to wezterm cli split-pane. This example launches bash as a login shell in a new pane at the bottom:

$ wezterm cli split-pane -- bash -l
3

This example creates a split to the left, occupying 30% of the available space:

$ wezterm cli split-pane --left --percent 30
4

The following options affect the behavior:

  • --cwd CWD - Specify the current working directory for the initially spawned program.
  • --horizontal - Equivalent to --right. If neither this nor any other direction is specified, the default is equivalent to --bottom.
  • --pane-id - Specifies the pane that should be split. See also Targeting Panes.

Since 20220624-141144-bd1b7c5d

  • --bottom - Split vertically, with the new pane on the bottom.
  • --cells CELLS - The number of cells that the new split should have. If omitted, 50% of the available space is used.
  • --left - Split horizontally, with the new pane on the left.
  • --move-pane-id MOVE_PANE_ID - Instead of spawning a new command, move the specified pane into the newly created split.
  • --percent PERCENT - Specify the number of cells that the new split should have, expressed as a percentage of the available space.
  • --right - Split horizontally, with the new pane on the right.
  • --top - Split vertically, with the new pane on the top.
  • --top-level - Rather than splitting the active pane, split the entire window.