# 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`