> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wherobots.com/llms.txt
> Use this file to discover all available pages before exploring further.
# File Explorer
> Upload, browse and manage your notebooks and scripts in My Files from the Files page, JupyterLab and the Wherobots CLI.
**File Explorer** lets you upload, browse and manage your notebooks and scripts in the **Wherobots Cloud** console. You can reach your files from the **Files** page, from JupyterLab, and from the Wherobots CLI.
Each user gets their own My Files location in every region they work in.
## Before you start
* A **Wherobots Account**. See [Create a Wherobots Account](/get-started/wherobots-cloud/create-account).
* The **Wherobots CLI**, version 1.3.0 or later. See [Install Wherobots CLI](/develop/cli). Check your version with `wherobots --version`, and update with `wherobots upgrade`.
* A signed-in CLI: run `wherobots auth login`, or set `WHEROBOTS_API_KEY`. See [Configure authentication](/develop/cli#configure-authentication).
## Choose a region
Each region has its own My Files. Choose the region before you work with files.
Go to the [**Files**](https://cloud.wherobots.com/files) page, expand the region, for example **AWS US West (Oregon)**, then expand **My Files** under it.
Pass `--region` after `my-files`:
```bash theme={"system"}
wherobots files my-files --region aws-us-west-2 ls
```
Without `--region`, the CLI uses your Organization's default region. If your Organization has none, the command fails with `your organization has no default region: pass --region `.
## Work with files and folders
### List a folder
In the tree, expand **My Files** in your region, then expand the folder you want to see.
```bash theme={"system"}
wherobots files my-files ls
wherobots files my-files ls projects/2026 --output json
```
The default output is a table with the columns `TYPE`, `SIZE`, `MODIFIED` and `NAME`. An empty folder prints `No files or folders.`, and so does a folder that does not exist, so check the spelling if you expect files. Use `--output json` in scripts.
### Create a folder
1. Select the **Actions** menu (the vertical dots) next to **My Files** or a folder.
2. Select **New Folder**, enter a **Folder Name**, and click **Create**.
`mkdir` creates the folder and any missing parent folders, and prints `Created folder projects/2026/q3`:
```bash theme={"system"}
wherobots files my-files mkdir projects/2026/q3
```
### Upload files
Each file can be up to 500 MiB.
1. Select the **Actions** menu next to **My Files** or the destination folder.
2. Select **Upload Files** and choose one or more files.
3. Click **Upload**.
If a file with the same name is already in the folder, the dialog warns that it "already exists here and will be replaced by the upload". Select **Replace the existing file** to continue.
Give the local file, then the path in My Files. When the path ends in `/`, the file keeps its local name:
```bash theme={"system"}
wherobots files my-files upload ./report.csv projects/report.csv
wherobots files my-files upload ./report.csv projects/
```
The command prints `Uploaded ./report.csv to ...`. If a file with the same name is already there, the CLI replaces it without asking.
The CLI uploads one file per command. To upload many, create the folder first, then loop over the files with modest parallelism. The API can answer HTTP 429 `Rate exceeded`, and the CLI does not retry for you, so retry failed files.
### Download a file
Select the file in the tree, then click the **Download** icon in the details panel, or select **Download** from the file's **Actions** menu.
Without a local path, the file is saved under its own name in the current folder. When the local path is an existing folder, the file is saved inside it:
```bash theme={"system"}
wherobots files my-files download projects/report.csv
wherobots files my-files download projects/report.csv ./backup/
```
### View a file
Select the file in the tree. The details panel shows a read-only preview for notebooks (`.ipynb`) and Python (`.py`) files up to 25 MiB. Larger files show **Too large to preview**, and other files show **No preview**.
```bash theme={"system"}
wherobots files my-files cat projects/report.csv
```
### Rename a file
Renaming is not available on the Files page. Use the CLI, or rename the file in a notebook. In the CLI, `mv` renames a file within its folder:
```bash theme={"system"}
wherobots files my-files mv projects/report.csv report-final.csv
```
If a file with the new name is already in the folder, `mv` replaces it without asking.
The Files page and the CLI cannot move a file to another folder. Move it in a notebook, or download it, upload it to the new folder, then delete the original.
### Delete a file or folder
1. Select the **Actions** menu next to the file or folder, then select **Delete**.
2. Type the name to confirm, and click **Delete**. Deleting a folder deletes everything inside it.
`rm` deletes a file. `rmdir` deletes an empty folder, and `--recursive` deletes a folder and everything in it:
```bash theme={"system"}
wherobots files my-files rm projects/report-final.csv
wherobots files my-files rmdir projects/2026/q3
wherobots files my-files rmdir projects --recursive
```
`rm` and `rmdir` print `Deleted ...` even when the path does not exist, so check the spelling of the path.
Deleting cannot be undone. If a running notebook saved files in a folder during the last minute, files in a deleted folder can come back. Delete folders from the notebook, or wait about a minute after the last save.
## Open a file in a notebook
On the Files page, you can open a text file such as `.ipynb`, `.py`, `.sql`, `.md`, `.csv`, `.txt` or `.json` straight into a new notebook.
1. Select the file in the tree.
2. Click the **Open File** icon in the details panel, or select **Open File** from the file's **Actions** menu. The **Open in a Notebook** dialog names the region and the path where the notebook will find the file.
3. Choose the runtime and other options if you need to, then click **Open**. A new notebook starts in the file's region, in a new browser tab, and JupyterLab opens the file when it is ready.
If your browser blocks the new tab, click **Open workspace** in the message on the Files page.
## Save your work in My Files
In JupyterLab, My Files is the **MY FILES** panel. In a notebook terminal, it is `/home/wherobots/workspace/my-files`. Files in **MY FILES** are kept across session restarts. Any other folder in the notebook's file system is deleted when the session restarts.
If your notebook still opens in your home folder, your home folder is kept too. See [If you used notebooks before My Files](#if-you-used-notebooks-before-my-files).
Example notebooks in the **EXAMPLES** panel are read-only. To change one, right-click it and choose **Copy to My Files**. See [Find your files](/develop/notebook-management/jupyter-notebook-management#find-your-files).
## How long changes take
Saving in a notebook is complete when Jupyter shows it as saved.
| Change | Where it appears | When |
| - | - | - |
| Save, create or rename in a notebook | Your notebooks in the same region | Immediately. When Jupyter shows a file as saved, it is stored and kept, even if your session restarts. |
| Upload or delete on the Files page, or upload, rename or delete with the CLI | Files page and CLI | The CLI shows the change immediately. On the Files page, your own changes show within a few seconds; changes made elsewhere appear when an open folder next refreshes itself, or when you click the **Refresh** icon. A collapsed folder shows them when you open it. |
| Save, create or rename in a notebook | Files page and CLI | About a minute after the file's last change |
| Delete in a notebook | Files page and CLI | About a minute after the delete |
| Upload in the Files page or the CLI | Notebook | Within a few seconds. |
| Delete in the Files page or the CLI | Notebook | Within a few seconds. When you delete many files at once, some can take up to about a minute. A deleted folder's files disappear, but the empty folder stays in a running notebook. |
## Use the CLI in scripts and agents
### Paths
The CLI takes paths relative to the root of My Files.
* A leading `/` is ignored: `/projects/report.csv` and `projects/report.csv` are the same file.
* A trailing `/` names a folder.
* Empty levels (`projects//report.csv`), `.` and `..` are refused before any request is sent.
* To see the requests a command would send without sending them, add `--dry-run`. The CLI prints each request as a `curl` command. Without `--region`, one request is still sent to look up your Organization's default region.
### Wait for a notebook's changes
In a script, check the file's `lastModified` time instead of waiting a fixed time. If the file already exists, the CLI lists the previous version until the change arrives, so wait for the time to change. A listed name alone does not mean the new version has arrived. This example uses [jq](https://jqlang.org):
```bash theme={"system"}
set -o pipefail
# Prints the file's lastModified time. Fails if the listing fails or the file is not listed yet.
modified() {
wherobots files my-files ls projects --output json \
| jq -er '.[] | select(.name == "analysis.ipynb") | .lastModified'
}
# Run this before you save in the notebook
before=$(modified) || before=""
# After you save, wait until the stored copy has the new version.
# A failed listing, for example HTTP 429, is retried instead of ending the wait.
until now=$(modified) && [ "$now" != "$before" ]; do
sleep 10
done
```
### Agentic terminals
To have an agentic terminal manage My Files for you, see [Using the Wherobots CLI with Agentic Terminals](/develop/cli-agentic-usage).
## If you used notebooks before My Files
If you used Wherobots notebooks before My Files, your notebook opens in your home folder. Your home folder keeps working as before, and My Files is already there, at `workspace/my-files`. Copy the files you want into My Files:
* **File browser:** right-click a file or folder and select **Copy**. Open `workspace/my-files`, right-click an empty area, and select **Paste**.
* **Terminal:** copy the folder's contents with `cp -r`. This works whether or not the folder already exists in My Files:
```bash theme={"system"}
mkdir -p ~/workspace/my-files/projects
cp -r ~/projects/. ~/workspace/my-files/projects/
```
The files appear on the [Files](https://cloud.wherobots.com/files) page about a minute after the copy finishes.
## Limitations
* **500 MiB per file** on the Files page and in the CLI.
* **Private to you.** Other members of your Organization cannot see your My Files.
* **Each region is separate.** A notebook can reach only the My Files of its own region. To work on a file from another region, use **Open File** on the Files page.
* **Meant for notebooks, code and small files.** For datasets, use [Managed Storage](/develop/storage-management/managed-storage) or an [S3 storage integration](/develop/storage-management/s3-storage-integration).
## Troubleshooting
**Cause:** The path does not exist in My Files in this region, or a file saved in a notebook in the last minute is not shown yet.
**Solution:** Check the path with `wherobots files my-files ls `, and pass `--region` if the file is in another region. For a notebook save, wait about a minute after the last change.
**Cause:** My Files is not available to you in that region.
**Solution:** Try another `--region`.
**Cause:** The file is larger than 500 MiB. The CLI message writes the limit as MB.
**Solution:** Split the file, or store it in [Managed Storage](/develop/storage-management/managed-storage) or an [S3 storage integration](/develop/storage-management/s3-storage-integration).
**Cause:** You sent too many requests in a short time, for example during a bulk upload.
**Solution:** Wait, retry the failed files, and lower the number of parallel uploads. See [Upload files](#upload-files).
**Cause:** The file is saved. The Files page shows it about a minute after the file's last change.
**Solution:** Wait about a minute after your last save. Open folders update on their own. If the folder is collapsed, expand it.
**Cause:** A running notebook saved files in the folder during the last minute, for example in `.ipynb_checkpoints`. The delete missed those files, and they were copied back.
**Solution:** Delete folders from the notebook, or wait about a minute after the last save, then delete the folder again.
For sign-in errors, see [Troubleshooting](/develop/cli#troubleshooting) on the Wherobots CLI page.
## Next steps
Find your files and run notebooks in JupyterLab.
Store datasets for your Organization.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.