pikvm — Claude Code skill: KVM over IP control
A skill for controlling remote servers via PiKVM: takes screenshots, types text, moves the mouse, presses keys, and toggles power.
no license 123 installs ★ 81 updated 2026-11-02
npx skills add okou-ai/okou-skills --skill pikvm -a claude-codeWhat pikvm does
Wraps the PiKVM HTTP API. The skill sends requests to the device: /api/streamer/snapshot for screenshots, /api/hid/print for text input, /api/hid/events/send_mouse_move for cursor positioning, /api/hid/events/send_key for keypresses, and /api/atx/power for power control. Mouse coordinates are measured from screen center: (0, 0) is the midpoint, negative values go left and up.
Requires PIKVM_URL (device address) and PIKVM_AUTH (credentials in user:pass format) as environment variables. Key combinations send two requests per key — press (state=true) then release (state=false), in reverse order for the release sequence. For a 1920×1080 screen, top-left is (-960, -540), bottom-right is (960, 540).
Supports mouse wheel scrolling via delta_y, device information retrieval, and hard server resets.
What it helps with
- Control a remote server without physical access
- Automate text input and keyboard commands over KVM
- Capture a screenshot of a machine connected to PiKVM
- Click the mouse at specific screen coordinates
- Reboot a server or toggle power via ATX
Example prompts for the agent
- Take a screenshot via PiKVM and save it to
/tmp/screenshot.jpg - Type
sudo rebooton the remote server through PiKVM - Move the mouse to
(-500, -300)and left-click
How to install pikvm
1Skills CLI (Vercel)
npx skills add okou-ai/okou-skills --skill pikvm -a claude-code2Manually: put the files in place
~/.claude/skills/pikvm/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pikvm/
1Skills CLI (Vercel)
npx skills add okou-ai/okou-skills --skill pikvm -a codex2Manually: put the files in place
.agents/skills/pikvm/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add okou-ai/okou-skills --skill pikvm -a cursor2Manually: put the files in place
.cursor/skills/pikvm/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install okou-ai/okou-skills pikvm2Manually: put the files in place
.github/skills/pikvm/SKILL.md1Skills CLI (Vercel)
npx skills add okou-ai/okou-skills --skill pikvm -a gemini-cli2Platform CLI
gemini skills install https://github.com/okou-ai/okou-skills --path pikvmManually: put the files in place
.devin/skills/pikvm/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add okou-ai/okou-skills --skill pikvm -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about pikvm
How to install pikvm in Claude Code?
Run npx skills add okou-ai/okou-skills --skill pikvm -a claude-code, the skill will appear in ~/.claude/skills/pikvm/SKILL.md.
What does the pikvm skill do?
Controls remote servers via PiKVM: takes screenshots, types text, moves the mouse, presses keys, and toggles power.
What environment variables does pikvm need?
Requires PIKVM_URL with the device address and PIKVM_AUTH with credentials in user:pass format.