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
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
--pane-id- Specifies the pane that should be split. See also Targeting Panes.
--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.