MUST be invoked before any work involving: charly check spice commands, SPICE protocol debugging, libvirt-VM display testing via the SPICE wire, or anything that needs to prove a SPICE server is speaking the protocol correctly (not just that the TCP port is open).

Command surface

charly check spice status     <vm>              # handshake + channel enumeration
charly check spice screenshot <vm> [FILE]       # native SPICE display-channel decode → PNG
charly check spice click      <vm> X Y          # mouse press/release via inputs channel
charly check spice mouse      <vm> X Y          # pointer move (no click)
charly check spice type       <vm> TEXT         # type text as PC-AT scancodes
charly check spice key        <vm> NAME         # press one named key (Return, Escape, F2, …)
charly check spice cursor     <vm> [FILE]       # capture cursor bitmap + position

Global flags on every subcommand: