Files and images
Files move both ways between you and an agent. You drop or paste a file into a session, and the agent gets its path. The agent shares a file with you, and it shows up next to the session.
Send a file to an agent
Section titled “Send a file to an agent”Drag a file from your desktop or file manager onto a session’s terminal. While you drag, the terminal shows Drop to send to and the name of the session’s host. Let go, and mocante:
- Copies the file to the host the session runs on.
- Types the file’s path at the prompt of the program in that terminal, followed by a space.
You can then finish your message around the path and press Enter. Claude Code reads a path it finds in the prompt, and Codex attaches a pasted image path as an image. A plain shell gets the path as text, as it would from any terminal.
This works the same on a remote host. A screenshot you drop on your Mac reaches a Claude Code that runs on a VM, which a terminal’s own drag and drop cannot do. For a remote host, a notice shows Sending file to host… while the file travels.
If you drop several files, each path arrives as its own paste, so an agent that attaches one image per paste gets all of them.
Paste an image or a copied file
Section titled “Paste an image or a copied file”Copy a screenshot or a file, click the terminal, and paste. When the clipboard holds an image or a file, mocante sends it the same way as a drop and types its path. A text paste works as usual.
On a local session, Claude Code’s own image paste (Ctrl+V inside Claude Code) still works too.
Limits and where dropped files go
Section titled “Limits and where dropped files go”- A file can be up to 1 GB. A larger file shows an error that says it is too large.
- While a file is sent, a notice shows how much has arrived, with a Cancel button. If you switch to another tab before it arrives, the path is not typed: the notice offers Copy path instead.
- The file is saved on the session’s host in
~/.cache/mocante/drops/. Its name keeps the original name behind a short stamp, for examplek3x9-Screenshot-2026-09-17.png, so the agent sees a readable name. Characters other than letters, digits,.,_and-are replaced. - Files older than seven days are removed from that folder the next time you drop a file.
See files an agent shares with you
Section titled “See files an agent shares with you”An agent that has mocante’s tools can hand you a file: a screenshot of the page it just checked, a recording of a failed test run, a report it wrote. You can ask for this directly, for example “take a screenshot of the login page and share it with me”. A screenshot the agent takes of the built-in browser is always shared with you.
When a file arrives:
- A bar above the session’s panes shows a thumbnail for each file you have not seen yet. Click the thumbnail of a picture or a recording to view it in the full-window viewer, with the shared files open behind it. Click the thumbnail of any other file to open the shared files over the panes at that file. The × dismisses the bar without opening anything.
- If you are looking at another session, a desktop notification tells you what arrived. Click it to open the shared files.
- A file that arrived while the app was closed still announces itself when you come back. A file you have seen stays quiet, in every window of that device.
Use the shared files
Section titled “Use the shared files”The shared files button at the top right of a session opens the shared files over the other panes. Click outside or press Esc to close them. To keep them open beside the other panes, click the pin button. See panes.
The shared files list everything the session’s agents have shared, newest first. Images show in the list and videos play in it. Any other file shows as a row that opens in the app your system uses for that kind of file.
Click a screenshot, or the expand button on a video, to view it over the whole window. In this view, press ← and → or click the arrows at the sides to go to the other shared files. Press Esc or click outside the file to close it.
To look closer at an image in this view:
- Scroll, or pinch on a trackpad or a phone, to zoom in at the pointer. The image zooms up to 8 times the size it fits at.
- Double-click, or double-tap, to zoom in at that point. Do it again to fit the image to the window.
- Drag a zoomed image to move it.
- Press
+or-to zoom in or out at the center, and0to fit the image again.
Going to another file fits the next image to the window.
To save one file, click the download button below it, or the one at the top when you view it over the whole window. The desktop app asks where to save it. So do Chrome and Edge; other browsers put it with your other downloads.
To save every shared file at once, click Download all at the top of the shared files. It asks where to save in the same way. The files download as one .tar.gz archive, named after the session’s branch, with one folder that holds each file under the name it had on the host. When two files have the same name, the later one gets a number, as in shot (2).png. On a Mac, a double-click extracts it. On a phone, or any page paired through a hub, the archive can be up to 200 MB. See phone.
Right-click a file for:
- View, for an image or a video
- Download…
- Open in a new window
- Copy the path on the host
- Remove…, which asks first
The command palette has these commands for the shared files:
- Show shared files / Hide shared files
- Pin the shared files beside the panes
- Mark the shared files as seen
- Download all shared files
- Clear the shared files…, which asks first and then empties the session’s list
- Open the shared files in a new window, and the other window commands that every pane has
Pinned beside the other panes, the shared files resize, reorder and pop out like any pane. See panes.
What an agent can share
Section titled “What an agent can share”- Any file the agent can read on its own host, up to 100 MB.
- Images (
png,jpg,gif,webp,avif,svg) show as images. - Videos (
mp4,webm,mov,ogv) play in the pane, if the format plays in Chromium. A video starts to play before the whole file has arrived. - Everything else is listed and opens outside the pane.
The file is copied to your device when the agent shares it, so the agent can change or delete its own copy afterwards. On a remote host the file travels back over ssh. Nothing extra is installed on the host.
Sharing needs no approval. It only moves a file the agent can already read into your own window.