| name | vnc-service |
| description | Persistent virtual display + VNC for headless servers. Four commands: /vnc-service:setup (install and configure), /vnc-service:run (ensure running + print connection info), /vnc-service:stop (stop services to free resources), /vnc-service:status (check health). Requires Debian/Ubuntu, systemd, sudo. VNC access restricted to local network via ufw firewall. Use whenever browser interaction is needed on a headless server — OAuth, CAPTCHA, 2FA. Other skills should call /vnc-service:setup as a prerequisite check and /vnc-service:run before browser operations. |
VNC Service Plugin
This plugin provides a persistent virtual display (Xvfb on :99) and VNC server (x11vnc on
port 5999, localhost only) for headless Linux servers. It enables browser-based interactions
that normally require a physical monitor.
Skills
/vnc-service:setup — One-time install and configuration/vnc-service:run — Ensure running + print connection info (call before browser operations)/vnc-service:stop — Stop services to free resources (restart anytime with /vnc-service:run)/vnc-service:status — Health check and diagnostics
For Other Skill Authors
If your skill needs browser interaction on a headless server, add this to your prerequisites:
### Prerequisite: Virtual Display (headless servers only)
Check if a display is available. If not:
1. Call /vnc-service:setup to install the virtual display service
2. Call /vnc-service:run before any browser operations
3. Wait for user to confirm VNC connection (via SSH tunnel)
4. Set DISPLAY=:99 for browser commands
