n2ns

Hyper Hand — AI skill for Claude Code

AI community

Let AI agents (Claude Code, Codex, any MCP client) control Hyper-V Windows VMs: screenshots, mouse, keyboard, commands, files and checkpoints, with no guest network or password.

How to install Hyper Hand

This entry records only its repository, not the path inside it, so there is no exact command to give. Open n2ns/hyper-hand and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Hyper Hand does

Let AI agents (Claude Code, Codex, any MCP client) control Hyper-V Windows VMs: screenshots, mouse, keyboard, commands, files and checkpoints, with no guest network or password.

Alternatives in AI

  • Peekaboo — Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, o 3.2k ★
  • Claude Skill Aso Appstore Screenshots — A Claude Code skill that generates high-converting App Store screenshots for your iOS app 1.2k ★
  • Oil UI — Push AI UI design to its limits: explore distinct directions, compare them side by side, and refine against re 861 ★

README

HyperHand: Hyper-V VM Control for AI Agents

Let an AI agent such as Claude Code or Codex see and operate a Windows virtual machine on Hyper-V: take screenshots, click, type, run commands, move files and roll back to checkpoints, without a network connection to the guest and without a guest password. Built for Windows 10/11 hosts running Hyper-V with Windows guests; works with any MCP client that supports Streamable HTTP.

HyperHand has two parts:

  • hyperhand.exe, a tray program on the host. It serves MCP at http://127.0.0.1:8770/mcp and drives the VM's screen, mouse and keyboard through Hyper-V.
  • hyperhand-agent.exe, a tray program inside the guest. It runs commands, transfers files and handles the clipboard and windows in the logged-on user's session, talking to the host over a Hyper-V socket.
HyperHand architecture: an MCP client talks to hyperhand.exe on the host, which drives the VM console through Hyper-V and the guest agent through a Hyper-V socket

Features

  • Screen, mouse and keyboard from the host: screenshots at the guest's resolution, clicks, drag, wheel, typing and key combinations. Works on the login screen and UAC prompts too, since it does not depend on anything running in the guest.
  • Commands in the guest: run PowerShell or cmd in the user's desktop session and get the exit code, stdout and stderr back; optionally elevated.
  • File transfer: copy files or whole directories in either direction, streamed at hundreds of MB/s. Uploads skip files whose SHA-256 already matches the guest copy.
  • Checkpoints: list, create and restore; a restored VM is started again automatically.
  • Clipboard, windows and waiting: read and write the guest clipboard, bring a window to the front, wait until a process exits or a file appears.
  • **No guest network, no guest pass