compuse-vnclisted

Use when you must drive a remote machine, VM, or GUI/TUI program over VNC/RFB - sending keystrokes and clicks and reading the screen with OCR - because the target has no network, SSH, agent, or API. Covers Proxmox/hypervisor VM consoles (first boot before networking, or a VM that will never have a network), legacy line-of-business GUIs and dated installers that are only a window, and old TUI apps driven by keypresses. Nothing is installed on the target - it needs only a VNC/RFB server, which a Proxmox VM console already exposes on the host. Driven with the `vnc-remote-control` CLI (PyPI).
bitranox/bitranox-skills · ★ 1 · AI & Automation · score 57

Install: claude install-skill bitranox/bitranox-skills

# Driving a remote machine over VNC (compuse-vnc) Drive a target's screen over plain VNC/RFB with the `vnc-remote-control` CLI: type text, press named keys, click, screenshot, and OCR. It is a pure **client** - nothing runs on the target, no agent, no service, no open port, nothing in its process list. The control happens entirely through a VNC/RFB server the target already exposes. ## When to use - **A target with no network.** A Proxmox/hypervisor VM that is not on the network yet (or never will be) is still driveable through its VNC console - the same screen as the web UI. Ideal for first-boot setup where you configure networking before the guest can reach anything. - **No footprint wanted.** Operate a machine with nothing installed or visible on it. - **VNC is the only door.** Remote admin where VNC is the one reachable interface. - **Legacy GUI software** with no API/CLI/accessibility tree - only a window. Read it with OCR, click by label. Legacy UIs rarely move, so coordinates stay stable. - **Old TUI programs** that you operate purely by keypresses (`type` + `key`); the target needs only a VNC server, which Proxmox provides out of the box. ## Step 0: install the tool, then use it (on YOUR control box only, never the target) This skill installs `vnc-remote-control` and then drives it. First make sure the CLI and tesseract are present on the machine you drive FROM (never on the target): ```bash # the CLI - persistent on PATH via uv; skip if already installe