velcro › Guides

Send a screenshot from your Mac to a remote server (for Claude Code or Codex over SSH)

When your coding agent runs on a server over SSH, pasting an image into the terminal doesn’t work. Put the file on a share both machines can see, and paste its path instead.

The problem

An SSH session carries text, not your Mac’s clipboard. If Claude Code, Codex, or another agent runs on a remote machine, the screenshot you just copied can’t be pasted into it. Most coding agents can read an image from a file path, though, so the trick is getting the file onto the server and the path into your clipboard.

Use the NAS both machines already share

If your server mounts the same NAS as your Mac (say the Mac sees /Volumes/home and the server sees /mnt/nas/me), velcro can do it in one click:

1. Copy a screenshot (Control-Shift-Command-4) or copy a file in Finder.
2. Open the velcro menu and pick it under Send to NAS.
3. velcro saves it in your NAS inbox and puts the server’s path on your clipboard, like /mnt/nas/me/inbox/clip-20260927-140312.png.
4. Paste that path into the agent.

velcro only changes your clipboard when you pick something, and never sends anything on its own.

Set it up

curl -fsSL https://velcro.dgit.co/install | sh
velcro set send.inbox /Volumes/home/inbox
velcro set map "/Volumes/home -> /mnt/nas/me"

From a terminal on the Mac, velcro send file.png does the same, and velcro send on its own sends whatever is on the clipboard. Files in the inbox are deleted after 14 days (velcro set send.keep 30 to change it, 0 to keep them).

Questions

Does this upload my screenshots anywhere?
No. The file is copied to a folder on your own NAS share. Nothing leaves your network unless your NAS does.