vnc-computer-use
VNC Computer-Use CLI - control a remote desktop via VNC for AI computer-use agents.
Installation
pip install vnc-computer-use
Claude Code Skill
To add VNC desktop control as a skill for Claude Code:
npx skills add EYHN/vnc --skill vnc
This installs the /vnc skill, which teaches Claude how to connect to VNC servers, take screenshots, click, type, and interact with remote desktops autonomously.
Usage
Connect to a VNC server
vnc connect localhost::5900
vnc connect myhost:0 --password secret
vnc connect myhost:0 --username user --password pass # macOS Screen Sharing
Interact with the remote desktop
# Screenshots
vnc get_screenshot -o screen.png
vnc get_screenshot # returns base64 JSON
# Keyboard
vnc key enter
vnc key ctrl-c
vnc type "hello world"
# Mouse
vnc left_click 100 200
vnc right_click 300 400
vnc double_click 100 200
vnc mouse_move 500 500
vnc left_click_drag 100 200
vnc scroll down 100 200
# Info
vnc get_cursor_position
vnc get_screen_size
vnc status
Multi-session support
vnc connect host1::5900 --session work
vnc connect host2::5900 --session personal
vnc -s work get_screenshot -o work.png
vnc -s personal left_click 100 200
Disconnect
vnc disconnect
vnc disconnect --session work
How it works
vnc launches a background daemon process that maintains a persistent VNC connection via vncdotool. The CLI communicates with the daemon over a Unix domain socket, making each action fast without reconnection overhead.
1 maintainer
Metadata
1 maintainer
Release files for vnc-computer-use 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| vnc_computer_use-0.2.1.tar.gz | 12.4 kB | With provenance | Details for vnc_computer_use-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| vnc_computer_use-0.2.1-py3-none-any.whl | Python 3 | none | any | Details for vnc_computer_use-0.2.1-py3-none-any.whl |
Total release size: 24.7 kB
Release files / vnc_computer_use-0.2.1.tar.gz
| Download URL | vnc_computer_use-0.2.1.tar.gz |
|---|---|
| Size | 12.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2b1629caa0e0a157b38e73ef773fae18f489d58bd858399ccc579b2167e088dd
|
|
BLAKE2b-256 checksum How to use checksums |
9ccbf27e8f5d7214cd6fabf684b019d19ded2d9559431129950c4c9dbe78609c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 7, 2026.
Transparency logRelease files / vnc_computer_use-0.2.1-py3-none-any.whl
| Download URL | vnc_computer_use-0.2.1-py3-none-any.whl |
|---|---|
| Size | 12.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9db2474ab609f31fff83b72ad98bf98a9d0d29d3e76de22e1952533baf3dd466
|
|
BLAKE2b-256 checksum How to use checksums |
f4f6582081f0a4cedfbd7a80c52a80b708ec2fd19cd714f16c1b6591216ea02c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 7, 2026.
Transparency logSecurity for vnc-computer-use 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for vnc_computer_use-0.2.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 7, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
