wezterm cli spawn¶
wezterm cli spawn --help to see more help
Spawn a command into a new tab or window. Outputs the pane-id for the newly created pane on success.
When run with no arguments, it will spawn a new tab running the default program; this example spawns a new pane with id 1 running that default program (most likely: your shell):
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 spawn so that any parameters you may wish to pass to the
program are not confused with parameters to
wezterm cli spawn. This example
top in a new tab:
This example explicitly runs bash as a login shell:
The following options affect the behavior:
--cwd CWD- Specifies the current working directory that should be set for the spawned program
--domain-name DOMAIN_NAME- Spawn into the named multiplexer domain. The default is to spawn into the domain of the current pane.
--new-window- Spawns the tab into a window of its own.
--workspace WORKSPACE- when using
--new-window, set the workspace name rather than using the default name of
--window-id WINDOW_ID- Spawn the tab into the specified window, rather than using the current window
Spawn a command into a new window or tab Outputs the pane-id for the newly created pane on success Usage: wezterm cli spawn [OPTIONS] [PROG]... Arguments: [PROG]... Instead of executing your shell, run PROG. For example: `wezterm cli spawn -- bash -l` will spawn bash as if it were a login shell Options: --pane-id <PANE_ID> Specify the current pane. The default is to use the current pane based on the environment variable WEZTERM_PANE. The pane is used to determine the current domain and window --domain-name <DOMAIN_NAME> --window-id <WINDOW_ID> Specify the window into which to spawn a tab. If omitted, the window associated with the current pane is used. Cannot be used with `--workspace` or `--new-window` --new-window Spawn into a new window, rather than a new tab --cwd <CWD> Specify the current working directory for the initially spawned program --workspace <WORKSPACE> When creating a new window, override the default workspace name with the provided name. The default name is "default". Requires `--new-window` -h, --help Print help