Get Moshi
feature

Image paste

undefined

updated 4 days ago17 min readpage 16 / 23

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 an image 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.

This is unique to Moshi. No other mobile SSH or mosh client offers it.

Sources

The terminal toolbar exposes two image sources today:

  • Photo library: pick any photo or screenshot.
  • Clipboard: grab the image already on the iOS clipboard — useful right after an iOS screenshot, a Safari long-press save, or a copy from another app.

Camera capture isn't supported yet.

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, or rm -rf ~/.moshi/uploads/* over SSH.

If Ctrl+V doesn't work

A few agents don't yet accept image 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

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