gridhandlisted

# gridhand Desktop GUI automation CLI. All commands return JSON to stdout (errors to stderr). ```bash gridhand screenshot --output /tmp/screen.png # full screen gridhand screenshot --window-id 123 --output /tmp/app.png # cropped to window gridhand screenshot --window-id 123 --grid --output /tmp/grid.png # grid overlay gridhand screenshot --window-id 123 --grid --cell B2 --output /tmp/z.png # zoom into cell gridhand windows list # JSON list of all windows gridhand windows raise 123 # bring window to front gridhand mouse click # click at current position gridhand mouse click --button right # right-click gridhand mouse click --cell B2.C1 --window-id 123 # click cell (recursive zoom OK) gridhand key type "hello" --window-id 123 # type text gridhand key press "ctrl+a" --window-id 123 # key combo (ctrl/shift/alt/super + key) ``` --- ## Grid Targeting No pixel coordinates exist. The grid is the only way to click. Each cell has a cyan crosshair (+) at its center — a click on that cell lands **exactly on that crosshair, nowhere else**. If the crosshair isn't on your target, the click will miss. Zoom until a crosshair sits directly on the target. ### Orient → Zoom → Click → Verify **Orient.** Take a grid screenshot. Identify which cell contains your target and note where within that cell it sits (