Commands

Observe the desktop

screenshot takes no positional arguments and writes the current combined desktop as a base64 PNG to standard output.

nano-use screenshot

Pointer actions

click x y posts one left-button click. right_click x y posts one right-button click. double_click x y posts two left-button clicks. All three validate the point against one axis-aligned bounding rectangle enclosing the active display rectangles, not against each display separately; points in gaps between displays can pass validation.

drag x1 y1 x2 y2 validates both endpoints, then posts a left-button down event, a dragged event, and a left-button up event.

nano-use click 320 240
nano-use right_click 320 240
nano-use double_click 320 240
nano-use drag 320 240 640 480

Text and key actions

type text posts the provided non-empty string as a keyboard event. keypress keys accepts one main key plus optional modifiers separated by +, such as cmd+return or shift+a. Named keys in the fixed source include arrows, navigation keys, delete variants, and f1 through f12.

nano-use type "bounded text"
nano-use keypress cmd+return

Scroll at a point

scroll x y dy validates the point, moves the cursor there, and posts one pixel-unit vertical scroll event using signed integer dy.

nano-use scroll 320 240 -480

These are positional arguments, not flags. The fixed source defines no additional command aliases.