# Agent Desktop Windows

Windows platform guide for the agent-desktop CLI.

- Repository: https://github.com/vercel-labs/agent-desktop (6655 stars)
- Category: Design
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add vercel-labs/agent-desktop --skill agent-desktop-windows -g -a claude-code -y`
Codex: `npx skills add vercel-labs/agent-desktop --skill agent-desktop-windows -g -a codex -y`
Cursor: `npx skills add vercel-labs/agent-desktop --skill agent-desktop-windows -g -a cursor -y`
Gemini CLI: `npx skills add vercel-labs/agent-desktop --skill agent-desktop-windows -g -a gemini-cli -y`

## Description

Windows platform guide for the agent-desktop CLI. Lists per command group what works on Windows and what refuses, the first-contact gotchas (PowerShell ref quoting, minimized windows, headed-only input), and where to find shell surfaces, notifications, the cursor overlay, UIPI elevation, Chromium/Electron settle behavior and troubleshooting. Triggers on: "windows desktop automation", "UIA tree", "automate Windows app", "agent-desktop on Windows", "elevated window input blocked", "E_ACCESSDENIED", or any Windows GUI interaction task.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# agent-desktop-windows

The observe-act loop, ref system, JSON envelope, sessions and tracing are the
same on every platform. This file covers only what differs on Windows.

Requires Windows 10 1809+ / Windows Server 2019+ (x64 or ARM64). Run it in the
interactive desktop session of the signed-in user. Session 0 (services and
SYSTEM tasks), Server Core, the secure desktop (UAC prompts, the sign-in
screen), a locked desktop and another user's session are not supported:
observation, actions and capture there fail or return nothing.

## Capability Table

The rest: https://github.com/vercel-labs/agent-desktop/blob/HEAD/skills/agent-desktop-windows/SKILL.md