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

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

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

A file can be up to 10 MB, the size the Claude API accepts for one image. A larger file shows an error that says it is too large.
The file is saved on the session’s host in ~/.cache/mocante/drops/. Its name keeps the original name behind a short stamp, for example k3x9-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

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”.

When a file arrives:

A bar above the session’s panes shows a thumbnail for each file you have not seen yet. Click a thumbnail to open the shared pane 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 pane.
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 pane

The shared pane lists everything the session’s agents have shared, newest first. Images show in the pane 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.

Right-click a file for:

Open in a new window
Copy the path on the host
Remove

The command palette has these commands for the shared pane:

Show shared pane / Hide shared pane
Mark the shared files as seen
Clear the shared files, which empties the session’s list
Open the shared files in a new window, and the other window commands that every pane has

The shared pane resizes, reorders and pops out like the other panes. See panes.

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.