Session.new_window

window_name (str | None) #

start_directory (StrPath | None) # – working directory in which the new window is created.

attach (bool) # – make new window the current window after creating it, default True.

window_index (str) # – create the new window at the given index position. Default is empty string which will create the window in the next available position.

window_shell (str | None) # – execute a command on starting the window. The window will close when the command exits. When this command exits the window will close. This feature is useful for long-running processes where the closing of the window upon completion is desired. Note:

environment (dict[str, str] | None) #

direction (WindowDirection | None) # – Insert window before or after target window.

target_window (str | None) # – Used by Window.new_window to specify the target window.

kill_existing (bool | None) # – Destroy the window at the target index if it already exists (-k flag). added 0.56

select_existing (bool | None) # – If a window with the given name already exists, select it instead of creating a new one (-S flag). added 0.56