Server.run_shell

command (str) # – Shell command to execute.

background (bool | None) # – Run in background (-b flag).

delay (str | None) # – Delay before execution (-d flag).

as_tmux_command (bool | None) # – Parse argument as a tmux command instead of a shell command (-C flag).

target_pane (str | None) # – Target pane for output (-t flag).

cwd (StrPath | None) # – Start directory for the shell command (-c flag). When omitted, tmux uses the target client's current working directory. Requires tmux 3.4+; on older tmux a warning is emitted and the kwarg is ignored. Note: tmux's -c is a start directory, not subprocess semantics. If chdir(cwd) fails, tmux falls back to the user's home directory, then to /, rather than raising — unlike Python's subprocess.Popen(cwd=) which errors on a failed chdir. added 0.57

show_stderr (bool | None) # – Combine the command's stderr into the captured output stream (-E flag, maps to JOB_SHOWSTDERR). Requires tmux 3.6+; on older tmux a warning is emitted and the kwarg is ignored. added 0.57

args (list[str] | None) # – Positional arguments passed after command, expanded as #{1}, #{2}, … inside it. Requires tmux 3.7+; warns and is ignored on older tmux.