Skip to content
moshpit

Docs · Topic

Files and images

When an agent writes a screenshot, recording, report, or log on the server, you can open it straight from the terminal—and send screenshots from your phone back into the agent’s prompt—over your existing SSH connection without signing in twice.

Moshpit resolves paths printed in terminal output against the pane’s working directory over SFTP (falling back to quoted shell commands when SFTP is disabled) and underlines existing previewable files:

  • Images (png, jpg, webp, gif, heic, svg, …) open in QuickLook.
  • Video and audio (mp4, mov, mp3, m4a, wav, flac, …) stream and play on the phone.
  • Documents and text (md, txt, json, csv, html, log, pdf, and Office/iWork documents) open in a reader with Share to export or save them.

Source code extensions (.rs, .ts, .py, …) are deliberately not underlined in terminal output so transcripts that name dozens of source files stay clean.

Tap a folder path in output, open the enclosing folder from a file preview, or tap Browse files on the terminal bar:

  • Images and videos render as a thumbnail grid; other files and subfolders render as rows with size and modification time.
  • Tap the folder title at the top to jump to any parent directory.
  • Tap + to upload from Photos… or Files, or create a New Folder.
  • Long-press any file or folder for Share, Rename, or Delete.

Tap Attach image on the terminal bar and choose Photos…, Take photo, or paste from the clipboard. Moshpit re-encodes photos on the phone so GPS location metadata never leaves your device, uploads each file sequentially over the session’s SSH channel, and pastes the remote path in the syntax the active agent expects (@path for Gemini CLI and Qwen Code, /add for aider, and a quoted path for Claude Code, Codex, and shells).

Open the iOS Share Sheet on a screenshot or photo in any app, pick Moshpit, and select the target agent pane. If that host isn’t currently connected, Moshpit queues the share and delivers it the next time the session comes up—checking first that the pane still exists and still runs the same agent, so an image path is never typed into a closed pane or a different program.