Skip to main content

​
Start a Session

  1. Launch Autopilot Desktop.
  2. Confirm the workspace path shown in the setup panel.
  3. Enter a task prompt.
  4. 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.
  • The UI receives ui-event updates (UiTreeReset, UiPatch, UiDataUpdate).
  • The Effuse canvas applies patches and 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.