> ## Documentation Index
> Fetch the complete documentation index at: https://www.rumus.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SFTP file browser

> Browse, upload, download, and edit files on any saved SSH host.

Every saved SSH host comes with a built-in SFTP file browser. You can browse the remote filesystem, upload files by drag-and-drop, download files back to your machine, and open remote files in the editor of your choice — all without leaving Rumus.

## Open the file browser

The file browser lives in the **left sidebar**. With a remote tab focused, the file tree shows the remote host's filesystem; with a local tab focused, it shows your local filesystem.

You can also open it explicitly from the sidebar's **Files** entry.

## Navigate

* **Click** a folder to expand it; click again to collapse.
* **Click** a file to select it; double-click to open it (more on opening below).
* The breadcrumb at the top of the tree shows your current path; click any segment to jump up.

### Hidden files

Files starting with `.` are hidden by default. Toggle **Show hidden files** in the tree's options menu to reveal them.

## Upload

The simplest way: **drag files from your operating system's file browser into the Rumus tree** (or onto the Upload dialog when prompted). The drop zone says *"Drop files here"*.

* Files upload into the folder you dropped them on (or the current folder if you drop on empty space).
* Each file uploads independently — there's no single multi-file progress bar today.
* The dialog shows per-file status as uploads complete.

You can also use the right-click context menu's **Upload File** entry, which opens a native file picker.

<Note>
  Upload is one-way (local → remote) via drag-and-drop today. To pull files the other direction, use **Download** from the file's right-click menu.
</Note>

## Download

From a file's right-click menu, choose **Download**. Rumus prompts for a save location on your local machine.

For folders, recursive download isn't built-in today — for whole-tree pulls, `tar` it on the remote and download a single archive, or use `rsync` from a local terminal.

## Edit a remote file

Right-click → **Edit**. Rumus opens the file in your configured external editor (set this in **Settings → Files**), uploads any saves back to the remote automatically, and watches the file for as long as you have it open.

This means you can edit a remote config file in VS Code (or whatever editor you use) without manually `scp`-ing it back and forth.

## Other actions

The right-click menu on a file or folder also includes:

* **Rename** — opens a small dialog; type the new name and confirm.
* **Delete** — asks for confirmation, then removes the file or folder.
* **Create folder** — make a new directory under the selection.
* **Copy path** — put the absolute remote path on your clipboard.

## What happens to file permissions

Uploaded files inherit the default permissions on the remote (your remote `umask`). Downloaded files inherit your local defaults. SFTP doesn't try to preserve modes across the two sides — if you need exact mode preservation, use `scp -p` or `rsync -a` from a terminal.

## Known limitations

Worth being explicit about what *isn't* there yet:

* **Bulk multi-file transfers** with one progress bar (uploads are per-file today).
* **Recursive folder download** — single files only.
* **Remote → local drag-and-drop** — use the right-click **Download** action instead.
* **Conflict resolution dialogs** for overwrites — re-uploading a file replaces the remote copy without a confirmation prompt today.
* **Bandwidth throttling** — transfers run as fast as the connection allows.

<Note>
  File-browser question we didn't cover? Ask in the [Rumus community](https://www.rumus.ai/community).
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="SSH host management" icon="server" href="/docs/remote/hosts">
    Save the hosts whose files you'll browse.
  </Card>

  <Card title="Resource monitoring" icon="chart-line" href="/docs/remote/monitoring">
    Watch CPU, memory, and disk while you transfer.
  </Card>
</CardGroup>