Clipboard to SSH for Claude Code or Cursor

Claude Code, Cursor, and Codex on a VM open files by path. They do not see your laptop clipboard. vmup --clip uploads what you copy and leaves one remote folder path to paste into the thread.

Same end state as First upload. This page is the clipboard loop. Full key list and pngpaste: Capture the clipboard. Screenshots as the job: Upload screenshots to a remote coding agent.

Capture

vmup --clip

vmup holds the terminal. Copy a file (Finder) or an image, press Enter, repeat, then type done.

On macOS, clipboard images need pngpaste. Copied files do not. Windows is not supported for --clip; use WSL and pass paths, or skip clip.

Zero captures: No files to upload, exit 2.

Paste into the agent

After upload, stdout looks like:

Uploaded 3 files → default
Agent folder: ~/vmup/agents-…/

Prompt:
Please inspect all files in ~/vmup/agents-…/

The folder path is already on the clipboard. Paste it into Claude Code, Cursor, or Codex in the same thread. The agent inspects that directory on the host.

Remote names are image-01.png, file-01.pdf, and so on. Original basenames are gone on the VM. How a batch is built explains the rename.

If the paste is not enough

The printed prompt is the sentence most agents need. If the model ignores a bare path, paste the Please inspect all files in … line too.

TTL still applies (default 5 minutes). Raise it for a longer session: Why batches expire.