pub struct ShellOptions {
pub init_profile: Option<ShellInitProfile>,
pub init_scripts: Option<Vec<ShellInitScript>>,
pub process_flags: Option<Vec<String>>,
}Expand description
Per-session settings for built-in shell tools.
Experimental. This type is part of an experimental wire-protocol surface and may change or be removed in future SDK or CLI releases.
Fields§
§init_profile: Option<ShellInitProfile>Controls automatic non-interactive profile loading where supported. Explicit initScripts are unaffected.
init_scripts: Option<Vec<ShellInitScript>>Ordered host-provided script paths sourced before each built-in shell command when the
entry’s shell target matches the active shell. Use these for rc files, environment setup scripts,
or other custom scripts. A script that returns a nonzero status is reported, and later scripts
and the user command continue while the shell remains running. Because scripts are sourced into
the command shell, exit, exec, failures under set -e, or other shell-terminating behavior
can prevent continuation. Script standard output is preserved; Bash script stderr is discarded,
PowerShell exception messages are replaced, and runtime-generated failure notices omit
configured script paths. When sandboxing is enabled, each script must already be readable under
the active sandbox filesystem policy. Pass an empty array to clear the list.
process_flags: Option<Vec<String>>Flags passed to the active built-in shell process on startup, replacing its default flags.
When omitted, the built-in Bash shell uses --norc --noprofile,
and the built-in PowerShell shell uses -NoProfile -NoLogo.
Trait Implementations§
Source§impl Clone for ShellOptions
impl Clone for ShellOptions
Source§fn clone(&self) -> ShellOptions
fn clone(&self) -> ShellOptions
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more