Struct AppState 

pub struct AppState {

    pub input: InputState,
    pub view: ViewState,
    pub selection: SelectionState,
    pub web: WebState,
    pub agents: HashMap<String, MonitoredAgent>,
    pub agent_order: Vec<String>,
    pub sort_by: SortBy,
    pub monitor_scope: MonitorScope,
    pub current_session: Option<String>,
    pub current_window: Option<u32>,
    pub teams: HashMap<String, TeamSnapshot>,
    pub target_to_pane_id: HashMap<String, String>,
    pub create_process: Option<CreateProcessState>,
    pub confirmation_state: Option<ConfirmationState>,
    pub error_message: Option<String>,
    pub last_poll: Option<DateTime<Utc>>,
    pub running: bool,
    pub show_activity_name: bool,
}

Application state

Fields

input: InputState

Input-related state

view: ViewState

UI view state (overlays, scroll, animations)

selection: SelectionState

Selection/navigation state

web: WebState

Web-related state

agents: HashMap<String, MonitoredAgent>

All monitored agents by target ID

agent_order: Vec<String>

Order of agents for display

sort_by: SortBy

Current sort method

monitor_scope: MonitorScope

Monitor scope for filtering panes

current_session: Option<String>

Current session name (for scope display)

current_window: Option<u32>

Current window index (for scope display)

teams: HashMap<String, TeamSnapshot>

Team snapshots by team name

target_to_pane_id: HashMap<String, String>

Mapping of tmux target (e.g. “main:0.1”) to pane_id (e.g. “5”) for IPC

create_process: Option<CreateProcessState>

Create process flow state (None if not in create mode)

confirmation_state: Option<ConfirmationState>

Confirmation dialog state (None if not showing)

error_message: Option<String>

Error message to display

last_poll: Option<DateTime<Utc>>

Last poll timestamp

running: bool

Whether the app is running

show_activity_name: bool

Show activity name (tool/verb) during Processing instead of generic “Processing”

Implementations

impl AppState

pub fn new() -> Self

Create a new application state

pub fn tick_spinner(&mut self)

Advance the spinner animation frame (time-based, ~150ms per frame)

pub fn spinner_char(&self) -> char

Get the current spinner character

pub fn tick_marquee(&mut self)

Advance the marquee scroll offset (time-based)

pub fn reset_marquee(&mut self, new_id: Option<String>)

Reset marquee state when selection changes

pub fn marquee_offset(&self) -> usize

Get the current marquee scroll offset

pub fn shared() -> SharedState

Create a shared state

pub fn selected_agent(&self) -> Option<&MonitoredAgent>

Get the currently selected agent

pub fn selected_agent_mut(&mut self) -> Option<&mut MonitoredAgent>

Get a mutable reference to the selected agent

pub fn selected_target(&self) -> Option<&str>

Get the selected agent’s target ID

pub fn update_agents(&mut self, agents: Vec<MonitoredAgent>)

Update agents from a new list

pub fn cycle_sort(&mut self)

Cycle through sort methods

pub fn cycle_monitor_scope(&mut self)

Cycle through monitor scopes

pub fn get_group_key(&self, agent: &MonitoredAgent) -> Option<String>

Get the current group key for an agent (for display headers)

pub fn toggle_group_collapse(&mut self, group_key: &str)

Toggle collapse state for a group

pub fn is_group_collapsed(&self, group_key: &str) -> bool

Check if a group is collapsed

pub fn select_previous(&mut self)

Move selection up

pub fn select_next(&mut self)

Move selection down

pub fn select_first(&mut self)

Select first entry

pub fn select_last(&mut self)

Select last entry

pub fn update_selectable_entries( &mut self, selectable_count: usize, agent_index: Option<usize>, )

Update selectable count and sync entry index

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

Get all unique directories from current agents

pub fn toggle_help(&mut self)

Toggle help screen

pub fn toggle_qr(&mut self)

Toggle QR code screen

pub fn init_web(&mut self, token: String, port: u16)

Initialize web settings

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

Get web URL for QR code

In WSL environments, returns Windows host IP instead of WSL internal IP, since external devices (phones) cannot access WSL’s internal network directly.

pub fn scroll_help_down(&mut self, amount: u16)

Scroll help screen down

pub fn scroll_help_up(&mut self, amount: u16)

Scroll help screen up

pub fn scroll_preview_down(&mut self, amount: u16)

Scroll preview down

pub fn scroll_preview_up(&mut self, amount: u16)

Scroll preview up

pub fn agents_needing_attention(&self) -> Vec<&MonitoredAgent>

Get agents that need attention (awaiting approval or error)

pub fn attention_count(&self) -> usize

Get count of agents needing attention

pub fn set_error(&mut self, message: String)

Set error message

pub fn clear_error(&mut self)

Clear error message

pub fn quit(&mut self)

Stop the application

pub fn enter_input_mode(&mut self)

Enter input mode

pub fn enter_passthrough_mode(&mut self)

Enter passthrough mode

pub fn exit_input_mode(&mut self)

Exit input mode and clear buffer

pub fn is_input_mode(&self) -> bool

Check if in input mode

pub fn is_passthrough_mode(&self) -> bool

Check if in passthrough mode

pub fn get_input(&self) -> &str

Get the input buffer

pub fn get_cursor_position(&self) -> usize

Get cursor position

pub fn input_char(&mut self, c: char)

Insert a character at cursor position

pub fn input_backspace(&mut self)

Delete character before cursor (backspace)

pub fn input_delete(&mut self)

Delete character at cursor (delete key)

pub fn cursor_left(&mut self)

Move cursor left

pub fn cursor_right(&mut self)

Move cursor right

pub fn cursor_home(&mut self)

Move cursor to start

pub fn cursor_end(&mut self)

Move cursor to end

pub fn take_input(&mut self) -> String

Take the input buffer content and clear it

pub fn start_create_process( &mut self, group_key: String, panes: Vec<PaneInfo>, config: &CreateProcessSettings, )

Start create process flow from a group

pub fn toggle_tree_node(&mut self, key: &str)

Toggle a node’s collapsed state in the create process tree

pub fn cancel_create_process(&mut self)

Cancel create process flow

pub fn is_create_process_mode(&self) -> bool

Check if in create process mode

pub fn show_confirmation(&mut self, action: ConfirmAction, message: String)

Show a confirmation dialog

pub fn cancel_confirmation(&mut self)

Cancel the confirmation dialog

pub fn is_showing_confirmation(&self) -> bool

Check if confirmation dialog is showing

pub fn get_confirmation_action(&self) -> Option<ConfirmAction>

Get the confirmation action (for execution)

pub fn create_process_cursor_up(&mut self)

Move cursor up in create process popup (skips headers in directory step)

pub fn create_process_cursor_down(&mut self, max: usize)

Move cursor down in create process popup (skips headers in directory step)

pub fn create_process_cursor(&self) -> usize

Get create process cursor position

Trait Implementations

impl Debug for AppState

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

Formats the value using the given formatter.

impl Default for AppState

fn default() -> Self

Returns the “default value” for a type.