peekaboo screen

screen list reports every connected display with its stable display ID, global logical bounds, scale factor, and primary state. Bare peekaboo screen defaults to screen list; the older peekaboo list screens spelling remains supported.

#Examples

# Human-readable display inventory
peekaboo screen list

# Coordinate-mapping fields for automation
peekaboo screen list --json \
  | jq '.data.screens[] | {id: .displayID, bounds, scale: .scaleFactor, main: .isPrimary}'

bounds and position use the same upper-left-origin global logical coordinate space as click --global-coords. Multiply dimensions by scaleFactor when comparing them with physical-pixel captures. A Retina display can therefore report logical bounds of 1944×1274, scale 2, and a 3888×2548 pixel capture.

For browser pages whose accessibility tree contains no actionable web descendants, pair this inventory with peekaboo window list --app <browser> --json, then use peekaboo click --window-id <id> --foreground --input-strategy synthOnly --coords x,y.