Start a Session
- Launch Autopilot Desktop.
- Confirm the workspace path shown in the setup panel.
- Enter a task prompt.
- Click Start Autopilot to connect the agent and begin the session.
What Happens During a Run
- The backend connects to Codex (via
codex-acp) and starts a session. - Events stream back from the agent (messages, tool calls, lifecycle events).
- App core maps events into view-model updates.
- WGPUI re-renders affected components.
Approvals and User Input
During a run, the agent may request approvals (command execution, file changes) or ask for user input. These requests are captured in the turn summary and can pause the run depending on guardrails.Unified Events (Chat Stream)
Autopilot emits a unified event stream with message chunks, tool calls, and session lifecycle events. These are normalized across agents, even when the underlying protocols differ.Current Limitations
- Unified events are emitted but not yet rendered directly in the canvas UI.
- Some events may be duplicated while raw ACP and unified events coexist.
- Error handling is improving; some failures may surface only in logs.