warpboard is for one narrow loop: agent or script is running over SSH UI state is visible on the Mac screenshot needs to get back into the remote shell

Today that is usually:

screenshot → save → scp → paste path

warpboard makes it:

copy screenshot Cmd+Shift+V in iTerm → /tmp/warpboard/...png

The terminal never sees a warpboard command. iTerm just inserts the remote path.

macOS + iTerm. Uses SSH. No OSC52, no remote service.

undefined