agent-vdesktop
Seretos/agent-vdesktop
Gerenciamento de Virtual Desktops Windows 11 para Claude Code
Ver no GitHubAgent que controla Virtual Desktops do Windows 11 nativamente ou via WSL. Cria/deleta/alterna desktops, aplica layouts customizados (colunas, grid, multi-monitor), lança Chrome/Terminal/VSCode em slots específicos e fixa apps entre desktops.
Instalação
npx convez-ai Seretos/agent-vdesktop1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Organizar espaço de trabalho com múltiplos desktops por projeto ou contexto
- Automatizar setup de desenvolvimento com layouts pré-configurados
- Pinotar aplicações e janelas em desktops específicos para workflow estruturado
Veredito

Ferramenta sólida de produtividade para usuários Windows 11 que querem automação via agente. A compatibilidade nativa com WSL é um diferencial, mas limitado ao ecossistema Windows e depende de builds recentes do SO.
README
A tradução para o português deste README ainda está na fila.
agent-vdesktop
Let your AI coding agent control Microsoft Virtual Desktops on Windows 11: create and switch desktops, apply column / grid / multi-monitor layouts, launch Chrome / Windows Terminal / VS Code into specific layout slots, pin apps across desktops, and address windows by label or content.
Works natively on Windows 11 and from inside WSL — the same binary runs in both contexts via Windows' binfmt_misc interop.
Quick install
Claude Code:
/plugin marketplace add Seretos/agent-marketplace
/plugin install agent-vdesktop@agent-marketplace
Self-contained .exe — no Python, no pip install, no dependencies.
Try it
Ask your agent something like:
create a desktop "demo", apply a 3-column layout, open Chrome on the left, a terminal in the middle, and VS Code on the right
The agent should call create_desktop → apply_layout → three launch_* tools, and the desktop should pop up.
Alternative installs
From the GitHub Releases page
If your agent doesn't support marketplaces, or you want a specific version manually:
- Download
vdesktop-plugin-<version>.zipfrom Releases. - Unpack to a stable folder (e.g.
C:\Users\<you>\.claude\plugins\agent-vdesktop\). - In Claude Code:
/plugin install <path-to-unpacked-folder>
From the release branch
The release branch always carries the latest install-ready files (no zip step):
git clone --branch release --depth 1 https://github.com/Seretos/agent-vdesktop.git
Then /plugin install <cloned-path> in Claude Code.
Build from source
Requires Python 3.11+ (standard python.org installer with the py launcher).
git clone https://github.com/Seretos/agent-vdesktop.git
cd agent-vdesktop
py -3 -m pip install -e ".[build]"
.\scripts\build.ps1 -Clean -Package
Output: bin/vdesktop.exe plus dist/vdesktop-plugin-<version>.zip. Then install via /plugin install <path>.
Notes
- Windows 10 is not supported.
IVirtualDesktopManagerInternalsemantics changed between Windows 10 and 11; only 11 works. - WSL invokes the
.exetransparently — no separate setup needed. - If
list_desktopsraisesCOMErrororOSError, the bundledpyvdapredates your Windows build. Wait for the next release, or build from source afterpip install -U pyvda. - Registry state (window labels, handle IDs) lives in memory and is reset when the MCP server restarts. Use
list_unmanaged_windows+adopt_windowto recover previously launched windows.