> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openagents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Autopilot

> Start sessions, run tasks, and understand live updates.

## 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.
* 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.