Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add okou-ai/okou-skills --skill pikvm -a claude-code
Open on GitHub

What 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 reboot on 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-code

2Manually: put the files in place

~/.claude/skills/pikvm/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pikvm/

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.

Similar skills

All skills for DevOps and infrastructure →

From the same set5

Project sponsors

Companies that keep this analytics open