AgentKVM

Check connection

agentkvm --json status

If this fails, the device isn't connected. Check the serial port with agentkvm list.

See the screen

agentkvm --json screenshot

Returns { "path": "/path/to/screenshot.png", ... }. Read the image to see what's on screen.

Interact

# Click at pixel coordinates (relative to the cropped image)
agentkvm mouse click 223 485
Type text
agentkvm type "hello world"
Press key combos
agentkvm key enter
agentkvm key ctrl+c
agentkvm key cmd+space
Scroll (positive = up, negative = down)
agentkvm mouse scroll 300 500 --delta -3
Drag from point A to point B
agentkvm mouse drag 100 200 400 600

Remote operation

If AgentKVM is running on another machine, all commands work identically with --remote:

agentkvm --remote http://192.168.1.100:7070 --token my-secret screenshot --json
agentkvm --remote http://192.168.1.100:7070 --token my-secret mouse click 223 485

Or use the HTTP API directly — see references/api.md.