Struct App 

pub struct App { /* private fields */ }

Main application component that orchestrates the entire Wisp TUI.

App owns two screens — a ConversationScreen for chat and a ScreenRouter for navigating to the git diff viewer — plus an optional SettingsOverlay.

Event routing

The parent event loop in run_with_state feeds three event sources into App:

• Terminal events — keystrokes and resizes, dispatched through Component::on_event.
• ACP events — streamed text chunks, tool calls, plans, and session lifecycle updates, dispatched through on_acp_event.
• Ticks — 100 ms heartbeats for animations (spinners, progress bars), gated by wants_tick.

Screen management

ScreenRouter tracks whether the user is viewing the conversation or the git diff. Ctrl+G toggles between them. The settings overlay floats above whichever screen is active.

See also

• ConversationScreen — the main chat UI
• RuntimeState — ACP session bootstrap that produces the inputs for App::new
• Keybindings — all keyboard shortcuts

Implementations

impl App

pub fn new( session_id: SessionId, agent_name: String, prompt_capabilities: PromptCapabilities, config_options: &[SessionConfigOption], auth_methods: Vec<AuthMethod>, working_dir: PathBuf, prompt_handle: AcpPromptHandle, ) -> Self

pub fn exit_requested(&self) -> bool

pub fn has_settings_overlay(&self) -> bool

pub fn needs_mouse_capture(&self) -> bool

pub fn wants_tick(&self) -> bool

pub fn on_acp_event(&mut self, event: AcpEvent)

Trait Implementations

impl Component for App

type Message = RendererCommand

The message type emitted by this widget.

async fn on_event(&mut self, event: &Event) -> Option<Vec<RendererCommand>>

Process an event and return the outcome.

fn render(&mut self, ctx: &ViewContext) -> Frame

Render the current state to a frame.