Get Moshi
feature

Image and file paste

One-tap paste from the phone to a coding agent — screenshots, photos, PDFs, logs, anything iOS can hand off.

updated 3 weeks ago21 min readpage 20 / 32

Image paste is Moshi's answer to the moment a coding agent needs to see something on your screen. On a desktop you would screenshot, drag the file into the agent, or run a one-liner to upload it. On a phone you would normally not even try.

Moshi collapses that into a single tap. It behaves like pressing Ctrl+V in a TUI like Claude Code or Codex — both treat Ctrl+V (not ⌘V) as the image-paste shortcut, even on Mac. You pick something on the phone; Moshi copies it to your host over SCP into ~/.moshi/uploads/; the agent gets a regular local file path it can open the same way it opens anything else.

Although it started life as image-only, the same flow now handles arbitrary files too — PDFs, logs, archives, configs, whatever iOS will let you hand off. This is unique to Moshi. No other mobile SSH or mosh client offers it.

One tap, straight into the promptPick a screenshot, photo, PDF, or log — Moshi SCPs it to your host and hands the agent a local path, like Ctrl+V on the desktop.

Sources

Tap the attach button in the terminal toolbar to open the Add attachment sheet. The options are:

  • Camera — capture a photo right now.
  • Photo — pick from the iOS photo library (photos and screenshots).
  • Files — open the iOS document picker for any file type — PDFs, code, archives, logs, configs.
  • Clipboard — appears only when iOS reports a usable item on the clipboard. Useful right after an iOS screenshot, a Safari long-press save, or a copy from another app.

The Clipboard row is hidden when the clipboard is empty or carries something Moshi can't handle, so you don't get a dead-end tap.

Where the path goes

What happens after the copy depends on context:

  • With chat mode on, the file path is attached to the composer alongside your dictated or typed text. See Voice and dictation.
  • With chat mode off, the file path is pasted directly into the terminal at the cursor — exactly as if you had typed it.
  • If remote clipboard is enabled, the absolute path is also placed on the host's clipboard so a follow-up paste on the desktop lands the same value.

Files accumulate in ~/.moshi/uploads/. Manage them from the Files screen (images surface there with thumbnails), or rm -rf ~/.moshi/uploads/* over SSH.

If Ctrl+V doesn't work

A few agents don't yet accept attachments from Ctrl+V. In that case, pair the pasted path with a direct instruction:

agent prompt
$> Review this screenshot and tell me which UI element is misaligned: ~/.moshi/uploads/2026-05-11-misalign.png
$> Summarize this log: ~/.moshi/uploads/2026-05-21-server.log

A bare path works, but the agent responds better when the request is explicit.