# pikvm

Скилл для управления удалёнными серверами через PiKVM: делает скриншоты экрана, печатает текст, двигает мышь, жмёт клавиши и переключает питание.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 123 установки · ★ 81 у репозитория
- Автор: okou-ai
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/okou-ai/okou-skills/tree/HEAD/pikvm/SKILL.md
- Обновлён: 2026-11-02
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/pikvm

## Что делает

Внутри — обёртки над HTTP API PiKVM. Скилл отправляет запросы к устройству: `/api/streamer/snapshot` для скриншота, `/api/hid/print` для ввода текста, `/api/hid/events/send_mouse_move` для перемещения курсора, `/api/hid/events/send_key` для нажатия клавиш и `/api/atx/power` для управления питанием. Координаты мыши считаются от центра экрана: `(0, 0)` — это середина, отрицательные значения — влево и вверх.

Требует переменные окружения `PIKVM_URL` (адрес устройства) и `PIKVM_AUTH` (логин и пароль в формате `user:pass`). Комбинации клавиш отправляются двумя запросами на каждую кнопку — сначала нажатие (`state=true`), потом отпускание (`state=false`), в обратном порядке для релиза. Для экрана 1920×1080 верхний левый угол — это `(-960, -540)`, правый нижний — `(960, 540)`.

Поддерживает прокрутку колёсиком мыши через `delta_y`, получение информации об устройстве и жёсткую перезагрузку сервера.

## Установка

### Claude Code (родная платформа)

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

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/pikvm/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/pikvm/

### Codex

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

2. **Вручную: положить файлы**
- Файл: `.agents/skills/pikvm/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

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

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/pikvm/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

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

2. **Вручную: положить файлы**
- Файл: `.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. **Командой платформы**
```bash
gemini skills install https://github.com/okou-ai/okou-skills --path pikvm
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/pikvm/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

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

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/okou-ai/okou-skills/tree/HEAD/pikvm/SKILL.md

## Когда брать
- Управлять удалённым сервером без физического доступа
- Автоматизировать ввод текста и клавиатурные команды через KVM
- Снять скриншот экрана машины, подключённой к PiKVM
- Кликнуть мышью в нужную точку экрана по координатам
- Перезагрузить сервер или включить питание через ATX

## Примеры запросов агенту
- Сделай скриншот экрана через PiKVM и сохрани в `/tmp/screenshot.jpg`
- Напечатай `sudo reboot` на удалённом сервере через PiKVM
- Передвинь мышь в координаты `(-500, -300)` и кликни левой кнопкой

## Похожие
- [kvm-pilot](https://affpapa.org/nevibecode/mcp/kvm-pilot.md) — MCP-сервер · ★ 20 у репозитория
- [proxmox](https://affpapa.org/nevibecode/skills/proxmox.md) — скилл · 1 установка
- [timebuzzer-led](https://affpapa.org/nevibecode/skills/timebuzzer-led.md) — скилл · 165 установок
- [step-parts](https://affpapa.org/nevibecode/skills/step-parts.md) — скилл · 12000 установок
- [zeroboot-vm-sandbox](https://affpapa.org/nevibecode/skills/zeroboot-vm-sandbox.md) — скилл · 1300 установок
- [proxmox-admin](https://affpapa.org/nevibecode/skills/proxmox-admin.md) — скилл · 886 установок

Из того же набора: [okou-ai/okou-skills](https://affpapa.org/nevibecode/by/okou-ai/okou-skills.md) — 5 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
