Claude Screenshot Uploader

📸 Claude Screenshot Uploader

Take a screenshot on your Mac, get a path you can paste straight into a remote Claude Code session.
🪟 On Windows? This is the macOS build, which lives in the menu bar via xbar. The Windows equivalent is at mdrzn/windows-screenshot-uploader.

🤔 Why

When Claude Code runs on a remote server over SSH, it can read files on *that* server — not the image sitting on your Mac's desktop. Pasting a screenshot into the terminal does nothing useful, so you end up repeating the same four steps by hand: save the image, scp it up, work out where it landed, type the path.

This collapses that into one step. Your screenshot ends up on the server and its remote path ends up on your clipboard, so the only thing left to do is paste.

⚙️ How it works

1. 📷 You take a screenshot, which lands in a folder you nominate.
2. 📤 It gets copied to your server over SSH with rsync.
3. 📋 The remote path goes on your clipboard, and a notification confirms it.

✨ Features

- 🖥️ Multiple servers — keep as many as you like and switch between them from the menu bar.
- 🎛️ Four upload modes — one click by hand, or fully automatic. Pick per install.
- 📋 Clipboard handoff — the remote path is ready to paste before the notification fades.
- 🔒 SSH keys only — no passwords are asked for, prompted for, or stored anywhere.
- 🔔 Native notifications — including when an upload fails, so it never fails silently.
- 🗑️ Optional cleanup — delete the local copy once it's safely uploaded, per server.
- ⬆️ Update checks — the menu tells you when a new version is out and updates in place.
- 📊 Activity log — the last few uploads are visible right in the menu.

📋 Requirements

- macOS — on Windows, use windows-screenshot-uploader instead
- xbar — provides the menu bar icon
- A server…