Struct TabManager 

pub struct TabManager { /* private fields */ }

Manages multiple terminal tabs within a single window

Implementations

impl TabManager

pub fn new() -> Self

Create a new empty tab manager

pub fn new_tab( &mut self, config: &Config, runtime: Arc<Runtime>, inherit_cwd_from_active: bool, grid_size: Option<(usize, usize)>, ) -> Result<TabId>

Create a new tab and return its ID

Arguments

• config - Terminal configuration
• runtime - Tokio runtime for async operations
• inherit_cwd_from_active - Whether to inherit working directory from active tab
• grid_size - Optional (cols, rows) override for initial terminal size. When provided, these dimensions are used instead of config.cols/rows. This is important when the renderer has already calculated the correct grid size accounting for tab bar height.

pub fn new_tab_with_cwd( &mut self, config: &Config, runtime: Arc<Runtime>, working_dir: Option<String>, grid_size: Option<(usize, usize)>, ) -> Result<TabId>

Create a new tab with a specific working directory

Used by arrangement restore to create tabs with saved CWDs.

pub fn new_tab_from_profile( &mut self, config: &Config, runtime: Arc<Runtime>, profile: &Profile, grid_size: Option<(usize, usize)>, ) -> Result<TabId>

Create a new tab from a profile configuration

The profile specifies the working directory, command, and tab name.

Arguments

• config - Terminal configuration
• runtime - Tokio runtime for async operations
• profile - Profile configuration to use
• grid_size - Optional (cols, rows) override for initial terminal size

pub fn close_tab(&mut self, id: TabId) -> bool

Close a tab by ID Returns true if this was the last tab (window should close)

pub fn remove_tab(&mut self, id: TabId) -> Option<(Tab, bool)>

Remove a tab by ID without dropping it, returning the live Tab.

Handles active tab switching and renumbering just like close_tab, but returns the Tab so the caller can keep it alive.

Returns Some((tab, is_empty)) if the tab was found, None otherwise.

pub fn insert_tab_at(&mut self, tab: Tab, index: usize)

Insert a live Tab at a specific index and make it active.

The index is clamped to 0..=self.tabs.len().

pub fn active_tab(&self) -> Option<&Tab>

Get a reference to the active tab

pub fn active_tab_mut(&mut self) -> Option<&mut Tab>

Get a mutable reference to the active tab

pub fn switch_to(&mut self, id: TabId)

Switch to a tab by ID

pub fn next_tab(&mut self)

Switch to the next tab (wraps around)

pub fn prev_tab(&mut self)

Switch to the previous tab (wraps around)

pub fn switch_to_index(&mut self, index: usize)

Switch to tab by index (1-based for Cmd+1-9)

pub fn move_tab(&mut self, id: TabId, direction: i32)

Move a tab left or right direction: -1 for left, 1 for right

pub fn move_tab_to_index(&mut self, id: TabId, target_index: usize) -> bool

Move a tab to a specific index (used by drag-and-drop reordering) Returns true if the tab was actually moved, false if not found or already at target

pub fn move_active_tab_left(&mut self)

Move active tab left

pub fn move_active_tab_right(&mut self)

Move active tab right

pub fn tab_count(&self) -> usize

Get the number of tabs

pub fn has_multiple_tabs(&self) -> bool

Check if there are multiple tabs

pub fn active_tab_id(&self) -> Option<TabId>

Get the active tab ID

pub fn tabs(&self) -> &[Tab]

Get all tabs as a slice

pub fn tabs_mut(&mut self) -> &mut [Tab]

Get all tabs as mutable slice

pub fn drain_tabs(&mut self) -> Vec<Tab>

Drain all tabs from the manager, returning them without dropping

This is used during fast shutdown to extract tabs so their terminals can be dropped on background threads in parallel.

pub fn get_tab(&self, id: TabId) -> Option<&Tab>

Get a tab by ID

pub fn get_tab_mut(&mut self, id: TabId) -> Option<&mut Tab>

Get a mutable reference to a tab by ID

pub fn mark_activity(&mut self, tab_id: TabId)

Mark non-active tabs as having activity when they receive output

pub fn update_all_titles(&mut self)

Update titles for all tabs

pub fn duplicate_active_tab( &mut self, config: &Config, runtime: Arc<Runtime>, grid_size: Option<(usize, usize)>, ) -> Result<Option<TabId>>

Duplicate the active tab (creates new tab with same working directory and color)

Arguments

• config - Terminal configuration
• runtime - Tokio runtime for async operations
• grid_size - Optional (cols, rows) override for initial terminal size

pub fn duplicate_tab_by_id( &mut self, source_tab_id: TabId, config: &Config, runtime: Arc<Runtime>, grid_size: Option<(usize, usize)>, ) -> Result<Option<TabId>>

Duplicate a specific tab by ID (creates new tab with same working directory and color)

Arguments

• source_tab_id - The ID of the tab to duplicate
• config - Terminal configuration
• runtime - Tokio runtime for async operations
• grid_size - Optional (cols, rows) override for initial terminal size

pub fn active_tab_index(&self) -> Option<usize>

Get index of active tab (0-based)

pub fn cleanup_dead_tabs(&mut self)

Clean up closed/dead tabs

Trait Implementations

impl Default for TabManager

fn default() -> Self

Returns the “default value” for a type.