Struct Profile 

pub struct Profile {

    pub id: Uuid,
    pub name: String,
    pub working_directory: Option<String>,
    pub shell: Option<String>,
    pub login_shell: Option<bool>,
    pub command: Option<String>,
    pub command_args: Option<Vec<String>>,
    pub tab_name: Option<String>,
    pub icon: Option<String>,
    pub order: usize,
    pub tags: Vec<String>,
    pub parent_id: Option<Uuid>,
    pub keyboard_shortcut: Option<String>,
    pub hostname_patterns: Vec<String>,
    pub tmux_session_patterns: Vec<String>,
    pub directory_patterns: Vec<String>,
    pub badge_text: Option<String>,
    pub badge_color: Option<[u8; 3]>,
    pub badge_color_alpha: Option<f32>,
    pub badge_font: Option<String>,
    pub badge_font_bold: Option<bool>,
    pub badge_top_margin: Option<f32>,
    pub badge_right_margin: Option<f32>,
    pub badge_max_width: Option<f32>,
    pub badge_max_height: Option<f32>,
    pub ssh_host: Option<String>,
    pub ssh_user: Option<String>,
    pub ssh_port: Option<u16>,
    pub ssh_identity_file: Option<String>,
    pub ssh_extra_args: Option<String>,
    pub source: ProfileSource,
}

A terminal session profile containing configuration for how to start a session

Fields

id: Uuid

Unique identifier for this profile

name: String

Display name for the profile

working_directory: Option<String>

Working directory for the session (if None, uses config default or inherits)

shell: Option<String>

Shell to use for this profile (e.g. “/bin/zsh”, “/usr/bin/fish”) When set, overrides the global custom_shell / $SHELL for this profile. Takes precedence over global config but is overridden by command.

login_shell: Option<bool>

Per-profile login shell override. None = inherit global config.login_shell, Some(true/false) = override.

command: Option<String>

Command to run instead of the default shell

command_args: Option<Vec<String>>

Arguments for the command

tab_name: Option<String>

Custom tab name (if None, uses default naming)

icon: Option<String>

Icon identifier for the profile (emoji or icon name)

order: usize

Display order in the profile list

tags: Vec<String>

Searchable tags to organize and filter profiles

parent_id: Option<Uuid>

Parent profile ID for inheritance (child overrides parent settings)

keyboard_shortcut: Option<String>

Keyboard shortcut for quick launch (e.g., “Cmd+1”, “Ctrl+Shift+1”)

hostname_patterns: Vec<String>

Hostname patterns for automatic profile switching when SSH connects Supports glob patterns (e.g., “.example.com”, “server-”)

tmux_session_patterns: Vec<String>

Tmux session name patterns for automatic profile switching when connecting via tmux control mode Supports glob patterns (e.g., “work-”, “dev-session”, “-production”)

directory_patterns: Vec<String>

Directory patterns for automatic profile switching based on CWD Supports glob patterns (e.g., “/Users//projects/work-”, “/home/user/dev/*”)

badge_text: Option<String>

Per-profile badge text (overrides global badge_format when this profile is active)

badge_color: Option<[u8; 3]>

Per-profile badge color [R, G, B] (overrides global badge_color)

badge_color_alpha: Option<f32>

Per-profile badge opacity 0.0-1.0 (overrides global badge_color_alpha)

badge_font: Option<String>

Per-profile badge font family (overrides global badge_font)

badge_font_bold: Option<bool>

Per-profile badge font bold (overrides global badge_font_bold)

badge_top_margin: Option<f32>

Per-profile badge top margin in pixels (overrides global badge_top_margin)

badge_right_margin: Option<f32>

Per-profile badge right margin in pixels (overrides global badge_right_margin)

badge_max_width: Option<f32>

Per-profile badge max width as fraction 0.0-1.0 (overrides global badge_max_width)

badge_max_height: Option<f32>

Per-profile badge max height as fraction 0.0-1.0 (overrides global badge_max_height)

ssh_host: Option<String>

SSH hostname for direct connection (profile acts as SSH bookmark)

ssh_user: Option<String>

SSH user for direct connection

ssh_port: Option<u16>

SSH port for direct connection

ssh_identity_file: Option<String>

SSH identity file path for direct connection

ssh_extra_args: Option<String>

Extra SSH arguments (e.g., “-o StrictHostKeyChecking=no”)

source: ProfileSource

Where this profile was loaded from (runtime-only, not persisted to YAML)

Implementations

impl Profile

pub fn new(name: impl Into<String>) -> Profile

Create a new profile with the given name

pub fn with_id(id: Uuid, name: impl Into<String>) -> Profile

Create a profile with a specific ID (for testing or deserialization)

pub fn working_directory(self, dir: impl Into<String>) -> Profile

Builder method to set working directory

pub fn shell(self, shell: impl Into<String>) -> Profile

Builder method to set shell

pub fn login_shell(self, login: bool) -> Profile

Builder method to set per-profile login shell

pub fn command(self, cmd: impl Into<String>) -> Profile

Builder method to set command

pub fn command_args(self, args: Vec<String>) -> Profile

Builder method to set command arguments

pub fn tab_name(self, name: impl Into<String>) -> Profile

Builder method to set tab name

pub fn icon(self, icon: impl Into<String>) -> Profile

Builder method to set icon

pub fn order(self, order: usize) -> Profile

Builder method to set order

pub fn tags(self, tags: Vec<String>) -> Profile

Builder method to set tags

pub fn parent_id(self, parent_id: Uuid) -> Profile

Builder method to set parent profile ID

pub fn keyboard_shortcut(self, shortcut: impl Into<String>) -> Profile

Builder method to set keyboard shortcut

pub fn hostname_patterns(self, patterns: Vec<String>) -> Profile

Builder method to set hostname patterns

pub fn tmux_session_patterns(self, patterns: Vec<String>) -> Profile

Builder method to set tmux session patterns

pub fn directory_patterns(self, patterns: Vec<String>) -> Profile

Builder method to set directory patterns

pub fn badge_text(self, text: impl Into<String>) -> Profile

Builder method to set badge text

pub fn badge_color(self, color: [u8; 3]) -> Profile

Builder method to set badge color

pub fn badge_color_alpha(self, alpha: f32) -> Profile

Builder method to set badge color alpha

pub fn badge_font(self, font: impl Into<String>) -> Profile

Builder method to set badge font

pub fn badge_font_bold(self, bold: bool) -> Profile

Builder method to set badge font bold

pub fn badge_top_margin(self, margin: f32) -> Profile

Builder method to set badge top margin

pub fn badge_right_margin(self, margin: f32) -> Profile

Builder method to set badge right margin

pub fn badge_max_width(self, width: f32) -> Profile

Builder method to set badge max width

pub fn badge_max_height(self, height: f32) -> Profile

Builder method to set badge max height

pub fn ssh_host(self, host: impl Into<String>) -> Profile

Builder method to set SSH host

pub fn ssh_user(self, user: impl Into<String>) -> Profile

Builder method to set SSH user

pub fn ssh_port(self, port: u16) -> Profile

Builder method to set SSH port

pub fn ssh_command_args(&self) -> Option<Vec<String>>

Build the SSH command arguments for this profile’s SSH connection. Returns None if ssh_host is not set.

pub fn display_label(&self) -> String

Get the display label (icon + name if icon exists)

pub fn validate(&self) -> Vec<String>

Validate the profile configuration Returns a list of validation warnings (not errors - profiles can be incomplete)

Trait Implementations

impl Clone for Profile

fn clone(&self) -> Profile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Profile

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

Formats the value using the given formatter.

impl Default for Profile

fn default() -> Profile

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Profile

fn deserialize<__D>( __deserializer: __D, ) -> Result<Profile, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Profile

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

where __S: Serializer,

Serialize this value into the given Serde serializer.