# pikvm

A skill for controlling remote servers via PiKVM: takes screenshots, types text, moves the mouse, presses keys, and toggles power.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 123 installs · ★ 81 repo stars
- Author: okou-ai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/okou-ai/okou-skills/tree/HEAD/pikvm/SKILL.md
- Updated: 2026-11-02
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/pikvm

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add okou-ai/okou-skills --skill pikvm -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/pikvm/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/pikvm/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add okou-ai/okou-skills --skill pikvm -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/pikvm/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add okou-ai/okou-skills --skill pikvm -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/pikvm/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install okou-ai/okou-skills pikvm
```

2. **Manually: put the files in place**
- File: `.github/skills/pikvm/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add okou-ai/okou-skills --skill pikvm -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/okou-ai/okou-skills --path pikvm
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/pikvm/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add okou-ai/okou-skills --skill pikvm -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/okou-ai/okou-skills/tree/HEAD/pikvm/SKILL.md

## When to use it
- 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
- 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

## Similar
- [kvm-pilot](https://affpapa.org/en/nevibecode/mcp/kvm-pilot.md) — MCP server · ★ 20 repo stars
- [proxmox](https://affpapa.org/en/nevibecode/skills/proxmox.md) — skill · 1 install
- [timebuzzer-led](https://affpapa.org/en/nevibecode/skills/timebuzzer-led.md) — skill · 165 installs
- [step-parts](https://affpapa.org/en/nevibecode/skills/step-parts.md) — skill · 12000 installs
- [zeroboot-vm-sandbox](https://affpapa.org/en/nevibecode/skills/zeroboot-vm-sandbox.md) — skill · 1300 installs
- [proxmox-admin](https://affpapa.org/en/nevibecode/skills/proxmox-admin.md) — skill · 886 installs

From the same set: [okou-ai/okou-skills](https://affpapa.org/en/nevibecode/by/okou-ai/okou-skills.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
