Struct Tab 

pub struct Tab {

    pub id: TabId,
    pub terminal: Arc<Mutex<TerminalManager>>,
    pub pane_manager: Option<PaneManager>,
    pub title: String,
    pub has_activity: bool,
    pub scroll_state: ScrollState,
    pub mouse: MouseState,
    pub bell: BellState,
    pub cache: RenderCache,
    pub refresh_task: Option<JoinHandle<()>>,
    pub working_directory: Option<String>,
    pub custom_color: Option<[u8; 3]>,
    pub has_default_title: bool,
    pub last_activity_time: Instant,
    pub last_seen_generation: u64,
    pub anti_idle_last_activity: Instant,
    pub anti_idle_last_generation: u64,
    pub silence_notified: bool,
    pub exit_notified: bool,
    pub session_logger: SharedSessionLogger,
    pub tmux_gateway_active: bool,
    pub tmux_pane_id: Option<TmuxPaneId>,
    pub detected_hostname: Option<String>,
    pub detected_cwd: Option<String>,
    pub auto_applied_profile_id: Option<ProfileId>,
    pub auto_applied_dir_profile_id: Option<ProfileId>,
    pub profile_icon: Option<String>,
    pub pre_profile_title: Option<String>,
    pub badge_override: Option<String>,
    pub coprocess_ids: Vec<Option<CoprocessId>>,
    pub script_manager: ScriptManager,
    pub script_ids: Vec<Option<ScriptId>>,
    pub script_observer_ids: Vec<Option<ObserverId>>,
    pub script_forwarders: Vec<Option<Arc<ScriptEventForwarder>>>,
    pub trigger_marks: Vec<ScrollbackMark>,
    pub pre_ssh_switch_profile: Option<ProfileId>,
    pub ssh_auto_switched: bool,
    /* private fields */
}

A single terminal tab with its own state (supports split panes)

Fields

id: TabId

Unique identifier for this tab

terminal: Arc<Mutex<TerminalManager>>

The terminal session for this tab (legacy - use pane_manager for new code)

pane_manager: Option<PaneManager>

Pane manager for split pane support

title: String

Tab title (from OSC sequences or fallback)

has_activity: bool

Whether this tab has unread activity since last viewed

scroll_state: ScrollState

Scroll state for this tab (legacy - each pane has its own)

mouse: MouseState

Mouse state for this tab (legacy - each pane has its own)

bell: BellState

Bell state for this tab (legacy - each pane has its own)

cache: RenderCache

Render cache for this tab (legacy - each pane has its own)

refresh_task: Option<JoinHandle<()>>

Async task for refresh polling

working_directory: Option<String>

Working directory when tab was created (for inheriting)

custom_color: Option<[u8; 3]>

Custom tab color [R, G, B] (0-255), overrides config colors when set

has_default_title: bool

Whether the tab has its default “Tab N” title (not set by OSC, CWD, or user)

last_activity_time: Instant

Last time terminal output (activity) was detected

last_seen_generation: u64

Last terminal update generation seen (to detect new output)

anti_idle_last_activity: Instant

Last activity time for anti-idle keep-alive

anti_idle_last_generation: u64

Last terminal generation recorded for anti-idle tracking

silence_notified: bool

Whether silence notification has been sent for current idle period

exit_notified: bool

Whether exit notification has been sent for this tab

session_logger: SharedSessionLogger

Session logger for automatic session recording

tmux_gateway_active: bool

Whether this tab is in tmux gateway mode

tmux_pane_id: Option<TmuxPaneId>

The tmux pane ID this tab represents (when in gateway mode)

detected_hostname: Option<String>

Last detected hostname for automatic profile switching (from OSC 7)

detected_cwd: Option<String>

Last detected CWD for automatic profile switching (from OSC 7)

auto_applied_profile_id: Option<ProfileId>

Profile ID that was auto-applied based on hostname detection

auto_applied_dir_profile_id: Option<ProfileId>

Profile ID that was auto-applied based on directory pattern matching

profile_icon: Option<String>

Icon from auto-applied profile (displayed in tab bar)

pre_profile_title: Option<String>

Original tab title saved before auto-profile override (restored when profile clears)

badge_override: Option<String>

Badge text override from auto-applied profile (overrides global badge_format)

coprocess_ids: Vec<Option<CoprocessId>>

Mapping from config index to coprocess ID (for UI tracking)

script_manager: ScriptManager

Script manager for this tab

script_ids: Vec<Option<ScriptId>>

Maps config index to ScriptId for running scripts

script_observer_ids: Vec<Option<ObserverId>>

Observer IDs registered with the terminal for script event forwarding

script_forwarders: Vec<Option<Arc<ScriptEventForwarder>>>

Event forwarders (shared with observer registration)

trigger_marks: Vec<ScrollbackMark>

Trigger-generated scrollbar marks (from MarkLine actions)

pre_ssh_switch_profile: Option<ProfileId>

Profile saved before SSH auto-switch (for revert on disconnect)

ssh_auto_switched: bool

Whether current profile was auto-applied due to SSH hostname detection

Implementations

impl Tab

pub fn new( id: TabId, tab_number: usize, config: &Config, runtime: Arc<Runtime>, working_directory: Option<String>, grid_size: Option<(usize, usize)>, ) -> Result<Self>

Create a new tab with a terminal session

Arguments

• id - Unique tab identifier
• tab_number - Display number for the tab (1-indexed)
• config - Terminal configuration
• runtime - Tokio runtime for async operations
• working_directory - Optional working directory to start in
• grid_size - Optional (cols, rows) override. When provided, uses these dimensions instead of config.cols/rows. This ensures the shell starts with the correct dimensions when the renderer has already calculated the grid size accounting for tab bar height.

pub fn new_from_profile( id: TabId, config: &Config, _runtime: Arc<Runtime>, profile: &Profile, grid_size: Option<(usize, usize)>, ) -> Result<Self>

Create a new tab from a profile configuration

The profile can override:

• Working directory
• Command and arguments (instead of default shell)
• Tab name

If a profile specifies a command, it always runs from the profile’s working directory (or config default if unset).

Arguments

• id - Unique tab identifier
• config - Terminal configuration
• _runtime - Tokio runtime (unused but kept for API consistency)
• profile - Profile configuration to use
• grid_size - Optional (cols, rows) override for initial terminal size

pub fn is_bell_active(&self) -> bool

Check if the visual bell is currently active (within flash duration)

pub fn update_title(&mut self)

Update tab title from terminal OSC sequences

pub fn set_default_title(&mut self, tab_number: usize)

Set the tab’s default title based on its position

pub fn set_title(&mut self, title: &str)

Explicitly set the tab title (for tmux window names, etc.)

This overrides any default title and marks the tab as having a custom title.

pub fn is_running(&self) -> bool

Check if the terminal in this tab is still running

pub fn get_cwd(&self) -> Option<String>

Get the current working directory of this tab’s shell

pub fn restore_pane_layout( &mut self, layout: &SessionPaneNode, config: &Config, runtime: Arc<Runtime>, )

Restore a pane layout from a saved session

Replaces the current single-pane layout with a saved pane tree. Each leaf in the tree gets a new terminal session with the saved CWD. If the build fails, the tab keeps its existing single pane.

pub fn parse_hostname_from_osc7_url(url: &str) -> Option<String>

Parse hostname from an OSC 7 file:// URL

OSC 7 format: file://hostname/path or file:///path (localhost) Returns the hostname if present and not localhost, None otherwise.

pub fn check_hostname_change(&mut self) -> Option<String>

Check if hostname has changed and update tracking

Returns Some(hostname) if a new remote hostname was detected, None if hostname hasn’t changed or is local.

This uses the hostname extracted from OSC 7 sequences by the terminal emulator.

pub fn check_cwd_change(&mut self) -> Option<String>

Check if CWD has changed and update tracking

Returns Some(cwd) if the CWD has changed, None otherwise. Uses the CWD reported via OSC 7 by the terminal emulator.

pub fn clear_auto_profile(&mut self)

Clear auto-applied profile tracking

Call this when manually switching profiles or when the hostname returns to local, or when disconnecting from tmux.

pub fn start_refresh_task( &mut self, runtime: Arc<Runtime>, window: Arc<Window>, max_fps: u32, )

Start the refresh polling task for this tab

pub fn stop_refresh_task(&mut self)

Stop the refresh polling task

pub fn set_custom_color(&mut self, color: [u8; 3])

Set a custom color for this tab

pub fn clear_custom_color(&mut self)

Clear the custom color for this tab (reverts to default config colors)

pub fn has_custom_color(&self) -> bool

Check if this tab has a custom color set

pub fn toggle_session_logging(&mut self, config: &Config) -> Result<bool>

Toggle session logging on/off.

Returns Ok(true) if logging is now active, Ok(false) if stopped. If logging wasn’t active and no logger exists, creates a new one.

pub fn is_session_logging_active(&self) -> bool

Check if session logging is currently active.

pub fn has_multiple_panes(&self) -> bool

Check if this tab has multiple panes (split)

pub fn pane_count(&self) -> usize

Get the number of panes in this tab

pub fn split_horizontal( &mut self, config: &Config, runtime: Arc<Runtime>, dpi_scale: f32, ) -> Result<Option<PaneId>>

Split the current pane horizontally (panes stacked vertically)

Returns the new pane ID if successful. dpi_scale converts logical pixel config values to physical pixels.

pub fn split_vertical( &mut self, config: &Config, runtime: Arc<Runtime>, dpi_scale: f32, ) -> Result<Option<PaneId>>

Split the current pane vertically (panes side by side)

Returns the new pane ID if successful. dpi_scale converts logical pixel config values to physical pixels.

pub fn close_focused_pane(&mut self) -> bool

Close the focused pane

Returns true if this was the last pane (tab should close)

pub fn close_exited_panes(&mut self) -> (Vec<PaneId>, bool)

Check for exited panes and close them

Returns (closed_pane_ids, tab_should_close) where:

• closed_pane_ids: Vec of pane IDs that were closed
• tab_should_close: true if all panes have exited (tab should close)

pub fn pane_manager(&self) -> Option<&PaneManager>

Get the pane manager if split panes are enabled

pub fn pane_manager_mut(&mut self) -> Option<&mut PaneManager>

Get mutable access to the pane manager

pub fn init_pane_manager(&mut self)

Initialize the pane manager if not already present

This is used for tmux integration where we need to create the pane manager before applying a layout.

pub fn set_pane_bounds( &mut self, bounds: PaneBounds, cell_width: f32, cell_height: f32, )

Set the pane bounds and resize terminals

This should be called before creating splits to ensure panes are sized correctly. If the pane manager doesn’t exist yet, this creates it with the bounds set.

pub fn set_pane_bounds_with_padding( &mut self, bounds: PaneBounds, cell_width: f32, cell_height: f32, padding: f32, )

Set the pane bounds and resize terminals with padding

This should be called before creating splits to ensure panes are sized correctly. The padding parameter accounts for content inset from pane edges.

pub fn focus_pane_at(&mut self, x: f32, y: f32) -> Option<PaneId>

Focus the pane at the given pixel coordinates

Returns the ID of the newly focused pane, or None if no pane at that position

pub fn focused_pane_id(&self) -> Option<PaneId>

Get the ID of the currently focused pane

pub fn is_pane_focused(&self, pane_id: PaneId) -> bool

Check if a specific pane is focused

pub fn navigate_pane(&mut self, direction: NavigationDirection)

Navigate to an adjacent pane

pub fn is_on_divider(&self, x: f32, y: f32) -> bool

Check if a position is on a divider

pub fn find_divider_at(&self, x: f32, y: f32) -> Option<usize>

Find divider at position

Returns the divider index if found

pub fn get_divider(&self, index: usize) -> Option<DividerRect>

Get divider info by index

pub fn drag_divider(&mut self, divider_index: usize, x: f32, y: f32)

Drag a divider to a new position

Trait Implementations

impl Drop for Tab

fn drop(&mut self)

Executes the destructor for this type.