convez.ai
AgenteProdutividadeIntermediário
Seretos

agent-vdesktop

Seretos/agent-vdesktop

Gerenciamento de Virtual Desktops Windows 11 para Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

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

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
agent-vdesktop--v0.1.4
Issues abertas
1
Contribuidores
1

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:

  1. Download vdesktop-plugin-<version>.zip from Releases.
  2. Unpack to a stable folder (e.g. C:\Users\<you>\.claude\plugins\agent-vdesktop\).
  3. 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. IVirtualDesktopManagerInternal semantics changed between Windows 10 and 11; only 11 works.
  • WSL invokes the .exe transparently — no separate setup needed.
  • If list_desktops raises COMError or OSError, the bundled pyvda predates your Windows build. Wait for the next release, or build from source after pip 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_window to recover previously launched windows.
Ver o original no GitHub

Bom para

Relacionados