Struct TerminalConfig 

pub struct TerminalConfig {
    pub jump_to_end_on_output: bool,
    pub shell: Option<TerminalShellConfig>,
    pub skip_app_execution_alias: bool,
    pub resume_agents: bool,
}

Terminal configuration

Fields

jump_to_end_on_output: bool

When viewing terminal scrollback and new output arrives, automatically jump back to terminal mode (default: true)

shell: Option<TerminalShellConfig>

Override the shell used by the integrated terminal.

When unset (the default), Fresh launches the shell named by the $SHELL environment variable (or the platform default if $SHELL is empty). Set this to run a different program — for example a wrapper script that forces an interactive shell — without having to change $SHELL for the whole process, which other features such as format_on_save also depend on.

Only affects local authorities; plugin-provided authorities (e.g. docker exec) keep their own wrapper.

skip_app_execution_alias: bool

Workaround for fresh#2077: when auto-detecting a shell on Windows, skip Microsoft Store App Execution Alias stubs (zero-byte APPEXECLINK reparse points under %LOCALAPPDATA%\Microsoft\WindowsApps). Spawning such a stub through ConPTY has been reported to crash with 0xc0000142 (STATUS_DLL_INIT_FAILED) on Windows 11 23H2.

Default true. Set to false to launch whatever pwsh.exe appears first on PATH, including the Store alias — useful if you want the old behavior, or if you’ve confirmed the alias works on your Windows build. No effect on non-Windows platforms or when terminal.shell is set explicitly.

resume_agents: bool

When restoring an Orchestrator agent session that recorded an agent-resume spec (e.g. claude --session-id <id> → resume with claude --resume <id>), rejoin the prior conversation instead of re-running the launch command fresh. Default true.

Set to false to always re-run the launch command on restore (the pre-resume behaviour) — useful if you’d rather a restart start each agent clean. No effect on sessions without a resume spec.

Trait Implementations

impl Clone for TerminalConfig

fn clone(&self) -> TerminalConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TerminalConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TerminalConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TerminalConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&TerminalConfig> for PartialTerminalConfig

fn from(cfg: &TerminalConfig) -> Self

Converts to this type from the input type.

impl JsonSchema for TerminalConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for TerminalConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.