Struct App 

pub struct App {

    pub project_root: Option<PathBuf>,
    pub session_name: String,
    pub session: Option<SpawnSession>,
    pub selected: usize,
    pub view_mode: ViewMode,
    pub show_help: bool,
    pub error: Option<String>,
    pub live_output: Vec<String>,
    pub input_buffer: String,
    pub scroll_offset: usize,
    pub auto_scroll: bool,
    pub focused_panel: FocusedPanel,
    pub waves: Vec<Wave>,
    pub selected_tasks: HashSet<String>,
    pub wave_task_index: usize,
    pub wave_scroll_offset: usize,
    pub agents_scroll_offset: usize,
    pub active_tag: Option<String>,
    pub ralph_mode: bool,
    pub ralph_max_parallel: usize,
    pub swarm_mode: bool,
    pub swarm_session_data: Option<SwarmSession>,
    /* private fields */
}

Application state

Fields

project_root: Option<PathBuf>

Project root directory

session_name: String

Session name being monitored

session: Option<SpawnSession>

Current spawn session data

selected: usize

Selected agent index

view_mode: ViewMode

Current view mode

show_help: bool

Show help overlay

error: Option<String>

Error message to display

live_output: Vec<String>

Live terminal output for selected agent (cached)

input_buffer: String

Input buffer for sending commands to agent

scroll_offset: usize

Scroll offset for terminal output (0 = bottom, positive = scrolled up)

auto_scroll: bool

Auto-scroll to bottom on new output

focused_panel: FocusedPanel

Which panel is currently focused

waves: Vec<Wave>

Execution waves with tasks

selected_tasks: HashSet<String>

Selected task IDs for batch spawning

wave_task_index: usize

Selected task index within waves panel

wave_scroll_offset: usize

Scroll offset for waves panel (first visible line)

agents_scroll_offset: usize

Scroll offset for agents panel (first visible line)

active_tag: Option<String>

Active tag for loading waves

ralph_mode: bool

Whether Ralph mode is enabled (auto-spawn ready tasks)

ralph_max_parallel: usize

Maximum parallel agents in Ralph mode

swarm_mode: bool

Whether we’re monitoring a swarm session (vs spawn session)

swarm_session_data: Option<SwarmSession>

Swarm session data (when swarm_mode is true)

Implementations

impl App

pub fn new( project_root: Option<PathBuf>, session_name: &str, swarm_mode: bool, ) -> Result<Self>

Create new app state

pub fn refresh(&mut self) -> Result<()>

Refresh session data from disk and update agent statuses

pub fn refresh_live_output(&mut self)

Refresh live output from the selected agent’s tmux pane

pub fn tick(&mut self) -> Result<()>

Periodic tick - refresh data as needed

pub fn toggle_ralph_mode(&mut self)

Toggle Ralph mode (autonomous wave execution)

pub fn agents(&self) -> &[AgentState]

Get agents list

pub fn next_agent(&mut self)

Select next agent

pub fn previous_agent(&mut self)

Select previous agent

pub fn adjust_agents_scroll(&mut self)

Adjust agents scroll offset to keep selected agent visible Assumes roughly 8 visible lines in the agents panel

pub fn toggle_fullscreen(&mut self)

Toggle fullscreen mode

pub fn exit_fullscreen(&mut self)

Exit current mode (go back to split)

pub fn enter_input_mode(&mut self)

Enter input mode

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

Add character to input buffer

pub fn input_backspace(&mut self)

Delete last character from input buffer

pub fn send_input(&mut self) -> Result<()>

Send the input buffer to the selected agent’s tmux pane

pub fn restart_agent(&mut self) -> Result<()>

Restart the selected agent (kill and respawn claude)

pub fn toggle_help(&mut self)

Toggle help overlay

pub fn scroll_up(&mut self, lines: usize)

Scroll terminal output up (show older content)

pub fn scroll_down(&mut self, lines: usize)

Scroll terminal output down (show newer content)

pub fn scroll_to_bottom(&mut self)

Jump to bottom of terminal output

pub fn status_counts(&self) -> (usize, usize, usize, usize)

Get status counts (starting, running, completed, failed)

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

Get the selected agent (if any)

pub fn refresh_waves(&mut self)

Refresh waves data from phases

pub fn all_wave_tasks(&self) -> Vec<&WaveTask>

Get flat list of all tasks in waves for navigation

pub fn selected_wave_task(&self) -> Option<&WaveTask>

Get currently selected wave task

pub fn next_panel(&mut self)

Switch focus to next panel

pub fn previous_panel(&mut self)

Switch focus to previous panel

pub fn move_up(&mut self)

Move selection up in current panel

pub fn move_down(&mut self)

Move selection down in current panel

pub fn toggle_task_selection(&mut self)

Toggle selection of currently highlighted task

pub fn select_all_ready(&mut self)

Select all ready tasks in waves

pub fn clear_selection(&mut self)

Clear all task selections

pub fn ready_task_count(&self) -> usize

Get count of ready tasks

pub fn selected_task_count(&self) -> usize

Get count of selected tasks

pub fn get_selected_tasks(&self) -> Vec<&WaveTask>

Get selected tasks for spawning

pub fn spawn_selected_tasks(&mut self) -> Result<usize>

Spawn the selected tasks Returns the number of tasks successfully spawned

pub fn prepare_swarm_start(&self) -> Option<(String, String)>

Prepare to start swarm - returns swarm command and tag

pub fn set_selected_task_status(&mut self, new_status: TaskStatus) -> Result<()>

Update the status of the currently selected agent’s task