Uploading Files

Upload files from the device you're browsing on to the machine running relay-tty. There are two distinct flows, depending on where you want the file to land.

Upload for use in a command

Use the upload icon in the session header when you want to reference a file in the terminal — attach an image to an AI session, feed a config to a script, and so on.

1. Tap the upload icon in the session header
2. Pick one or more files
3. Files are saved to your configured upload directory (~/.relay-tty/uploads by default)
4. The absolute paths are pasted at the terminal prompt, space-separated, ready to use as command arguments. A path containing spaces or shell metacharacters is wrapped in single quotes so it survives as one argument; plain paths are pasted as-is

If the mobile scratchpad is open when the upload finishes, the paths are appended to the scratchpad input instead of being typed into the terminal, so you can keep composing your command.

Three shortcuts trigger the same flow:

• Drag and drop — drop files anywhere on the terminal (desktop)
• Paste an image — pasting clipboard image data (like a screenshot) uploads it as a timestamped PNG and pastes its path
• Paste a file from Finder — copy one or more files in macOS Finder (Cmd-C), then paste into the terminal (Cmd-V). The files are uploaded and their paths pasted, exactly like drag-and-drop. Chrome and Safari hide the original filesystem path from web pages, so an upload is the only way the session can reach the file; if a browser does expose the real absolute path, that path is pasted instead and nothing is uploaded

The destination for this flow is configurable in Settings → Upload Directory.

Upload into a specific folder

Use the upload button inside the file browser when you want the file in a particular place — dropping an asset into a project, replacing a config file, and so on.

1. Open the file browser (folder icon in the session header)
2. Navigate to the destination folder
3. Tap the upload icon in the file browser toolbar and pick files
4. The files are uploaded into the folder you're viewing and appear in the listing immediately

Nothing is typed into the terminal by this flow. To use an uploaded file's path, long-press (mobile) or right-click (desktop) it in the listing and choose Copy absolute path. The clipboard gets the same shell quoting as pasted upload paths.

Limits

• Maximum file size: 100 MB per file
• Duplicate filenames get a short random suffix instead of overwriting (report.pdf → report-a1b2c3.pdf)