How do I install the Winuse Client skill?

Run npx skillmds@latest add tomevault-io/winuse-client in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Winuse Client safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Winuse Client?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Winuse Client free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Winuse Client?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Winuse Client by tomevault-io — Agent Skill

Name: Winuse Client
Author: tomevault-io

Winuse Client

Python CLI client for remote Windows desktop automation via the WinUse API. Use when working with WinUse to control Windows machines remotely - listing windows, focusing windows, sending keyboard/mouse input, taking screenshots, and automating GUI interactions. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

WinUse Client

Python CLI client for remote Windows desktop automation via the WinUse API.

Quick Start

Install the client:

cd ~/dev/winuse-client
pip install -e . --break-system-packages

Set the WinUse server URL:

export WINUSE_URL=lab          # hostname
export WINUSE_URL=lab:8080     # hostname with port
export WINUSE_URL=192.168.1.100:8080  # IP with port

Or use --url with any command.

Common Operations

List Windows

winuse list                           # All windows
winuse list --filter "Terminal"       # Filter by title

Focus Windows

winuse focus --hwnd 329166            # By handle
winuse focus --title "kimi"           # By title (fuzzy match)

Send Input

# Type text
winuse type "Hello World" --title "notepad"

# Press key combinations
winuse key ctrl,n --title "kimi"      # New tab
winuse key ctrl,shift,r               # Rename tab
winuse key alt,f4                     # Close window

# Paste clipboard
winuse paste --title "kimi"

Mouse Control

winuse mouse_click 500 300            # Click at coordinates
winuse mouse_click 500 300 --double   # Double-click
winuse move 500 300                   # Move cursor

Screenshots

winuse screenshot                     # URL to screenshot
winuse screenshot -o ./capture.png    # Save to file

Window Management

winuse minimize --hwnd 329166
winuse maximize --title "kimi"
winuse restore --hwnd 329166
winuse close --title "notepad"        # Alt+F4

Chaining Operations

Use send for multiple operations on one window:

winuse send --title "kimi" --keys "ctrl,n" --text "docker" --keys "enter"

URL Format

The --url flag and WINUSE_URL env var accept:

Hostname: lab
Hostname:port: lab:9000
IP: 192.168.1.100
IP:port: 192.168.1.100:8080
Full URL: http://lab:8080, https://winuse.example.com

Default port is 8080 if not specified.

Reference

See references/api.md for complete API endpoint documentation.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: winuse-clientdescription: Python CLI client for remote Windows desktop automation via the WinUse API. Use when working with WinUse to control Windows machines remotely - listing windows, focusing windows, sending keyboard/mouse input, taking screenshots, and automating GUI interactions. Use when this capability is needed.---# WinUse ClientPython CLI client for remote Windows desktop automation via the WinUse API.## Quick StartInstall the client:```bashcd ~/dev/winuse-clientpip install -e . --break-system-packages```Set the WinUse server URL:```bashexport WINUSE_URL=lab # hostnameexport WINUSE_URL=lab:8080 # hostname with portexport WINUSE_URL=192.168.1.100:8080 # IP with port```Or use `--url` with any command.## Common Operations### List Windows```bashwinuse list # All windowswinuse list --filter "Terminal" # Filter by title```### Focus Windows```bashwinuse focus --hwnd 329166 # By handlewinuse focus --title "kimi" # By title (fuzzy match)```### Send Input```bash# Type textwinuse type "Hello World" --title "notepad"# Press key combinationswinuse key ctrl,n --title "kimi" # New tabwinuse key ctrl,shift,r # Rename tabwinuse key alt,f4 # Close window# Paste clipboardwinuse paste --title "kimi"```### Mouse Control```bashwinuse mouse_click 500 300 # Click at coordinateswinuse mouse_click 500 300 --double # Double-clickwinuse move 500 300 # Move cursor```### Screenshots```bashwinuse screenshot # URL to screenshotwinuse screenshot -o ./capture.png # Save to file```### Window Management```bashwinuse minimize --hwnd 329166winuse maximize --title "kimi"winuse restore --hwnd 329166winuse close --title "notepad" # Alt+F4```## Chaining OperationsUse `send` for multiple operations on one window:```bashwinuse send --title "kimi" --keys "ctrl,n" --text "docker" --keys "enter"```## URL FormatThe `--url` flag and `WINUSE_URL` env var accept:- Hostname: `lab`- Hostname:port: `lab:9000`- IP: `192.168.1.100`- IP:port: `192.168.1.100:8080`- Full URL: `http://lab:8080`, `https://winuse.example.com`Default port is 8080 if not specified.## ReferenceSee `references/api.md` for complete API endpoint documentation.---> Converted and distributed by [TomeVault](https://tomevault.io/claim/nedos) — claim your Tome and manage your conversions.

Frequently asked questions