Skip to content

Solving Simple Things: Pasting images to Claude over SSH sessions

· engineering

I often run Claude over SSH. When I need to show it a UI bug, the screenshot is on the Mac in front of me, while the Claude session is on another machine. Pasting into the terminal does not send the image across with the text.

I built Tailshot to make that handoff one shortcut. It is a small macOS menu-bar app paired with a Python image server. I press Option+1, it captures my main display, uploads a PNG over my tailnet, and copies a link. I paste that link into the Claude session so the remote machine can fetch the image.

The part that matters

My tailnet has several devices, including a work laptop and a personal workstation. Either one might be off when I take a screenshot. I run the image server on each device, so the capture app looks for an available remote machine and uploads to one that responds. The link points to the machine that received the image. Because the devices share a tailnet, the machine running my SSH session can reach it even if the image landed somewhere else.

The server accepts uploads with a token and gives each image an unguessable URL. Anyone in the tailnet with that URL can read the image until it expires; the default is one hour. The server deletes expired images. If no server is online, the upload fails rather than producing a broken link.

That is the whole loop: screenshot, paste link, continue the conversation. The image does not need to live on the same machine as Claude, and I do not have to move it by hand each time.