Files
coder/docs/ai-coder/agents/platform-controls/virtual-desktop.md
T
Nick Vigilante 9eba637584 docs(docs/ai-coder/agents): reformat to one sentence per line (#30700)
Reformats the Coder Agents docs under `docs/ai-coder/agents` to one
sentence per line, as the [docs style
guide](https://github.com/coder/coder/blob/main/docs/.style/style-guide/formatting.md#one-sentence-per-line)
requires. Hard-wrapped paragraphs are unwrapped and lines holding
several sentences are split, so a later edit to one sentence shows up as
a one-line diff.

Apart from the exception below, only whitespace inside paragraphs and
list items changes, and the rendered pages are the same. Comparing the
changed files against `main` word for word, ignoring whitespace and
blockquote `>` markers, finds differences only on the reworded lines.
`git diff --word-diff` is easier to read than the line diff.

59 lines that already contained an em or en dash were reworded by hand,
because `lint/emdash` treats every reflowed line as newly added. Each
uses a parenthetical, a separate sentence, or a colon after a lead-in.
Dashes on lines the reflow did not touch are left alone.

Applied with an in-progress formatter, limited to pages listed in
`docs/manifest.json` and excluding generated reference docs. This is one
of a batch of PRs that split the docs by area (21 files changed, 870
insertions(+), 1294 deletions(-)).

---
🤖 Built with AI assistance.
2026-10-15 14:38:40 -04:00

1.3 KiB

title
title
Virtual desktop

Note

This feature is experimental. Pin a release before broad rollout and review the release notes before upgrading.

Enable the experiment

coder server --experiments=chat-virtual-desktop

Or set the environment variable:

CODER_EXPERIMENTS=chat-virtual-desktop

What it does

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

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