# Virtual desktop

<Callout type="info" title="Note">
  This feature is experimental. Pin a release before broad rollout and review
  the release notes before upgrading.
</Callout>

## Enable the experiment [#enable-the-experiment]

```sh
coder server --experiments=chat-virtual-desktop
```

Or set the environment variable:

```sh
CODER_EXPERIMENTS=chat-virtual-desktop
```

## What it does [#what-it-does]

Lets agents drive a graphical desktop inside the workspace through
`spawn_agent` with `type=computer_use` (screenshots, mouse, keyboard).

## Configuration [#configuration]

Once the experiment is enabled, configure the computer-use provider under
**Admin settings** > **AI** > **Coder Agents** > **Deployment settings**.
Use the **Virtual desktop** card.

Choose a **Computer use provider** (Anthropic or OpenAI). Virtual desktop also requires:

* The [portabledesktop](https://registry.coder.com/modules/coder/portabledesktop)
  module installed in the workspace template.
* An API key for the selected provider configured under the **Providers**
  sidebar item.

The Anthropic and OpenAI computer-use models are fixed by Coder per provider
and are not selectable from this UI. Anthropic is the default when no
provider is set.

The same configuration is available at:

* `GET /api/v2/chats/config/computer-use-provider`
* `PUT /api/v2/chats/config/computer-use-provider`