1
1
mirror of https://github.com/wez/wezterm.git synced 2024-12-27 15:37:29 +03:00
wezterm/docs/examples/cmd-synopsis-wezterm-start--help.txt

67 lines
2.7 KiB
Plaintext
Raw Normal View History

Start the GUI, optionally running an alternative program [aliases: -e]
Usage: wezterm start [OPTIONS] [PROG]...
Arguments:
[PROG]...
Instead of executing your shell, run PROG. For example: `wezterm start
-- bash -l` will spawn bash as if it were a login shell. [aliases: -e]
Options:
--no-auto-connect
If true, do not connect to domains marked as connect_automatically in
your wezterm configuration file
--always-new-process
If enabled, don't try to ask an existing wezterm GUI instance to start
the command. Instead, always start the GUI in this invocation of
wezterm so that you can wait for the command to complete by waiting
for this wezterm process to finish
--new-tab
When spawning into an existing GUI instance, spawn a new tab into the
active window rather than spawn a new window
--cwd <CWD>
Specify the current working directory for the initially spawned
program
--class <CLASS>
Override the default windowing system class. The default is
"org.wezfurlong.wezterm". Under X11 and Windows this changes the
window class. Under Wayland this changes the app_id. This changes the
class for all windows spawned by this instance of wezterm, including
error, update and ssh authentication dialogs
--workspace <WORKSPACE>
Override the default workspace with the provided name. The default is
"default"
--position <POSITION>
Override the position for the initial window launched by this process.
--position 10,20 to set x=10, y=20 in screen coordinates
--position screen:10,20 to set x=10, y=20 in screen coordinates
--position main:10,20 to set x=10, y=20 relative to the main
monitor
--position active:10,20 to set x=10, y=20 relative to the active
monitor
--position HDMI-1:10,20 to set x=10, y=20 relative to the monitor
named HDMI-1
Note that Wayland does not allow applications to control window
positioning.
--domain <DOMAIN>
Name of the multiplexer domain section from the configuration to which
you'd like to connect. If omitted, the default domain will be used
--attach
When used with --domain, if the domain already has running panes,
wezterm will simply attach and will NOT spawn the specified PROG. If
you omit --attach when using --domain, wezterm will attach AND then
spawn PROG
-h, --help
Print help (see a summary with '-h')