File Explorer

File Explorer lets you upload, browse and manage your notebooks and scripts in the Wherobots Cloud console. You can reach your files from the Code page, previously called the Files page, from JupyterLab, and from the Wherobots CLI.

Each user gets their own My Files location in every region they work in.

Code page with My Files expanded in AWS EU (Ireland) — The Code page with My Files in AWS EU (Ireland)

Before you start

Code page
CLI

A Wherobots Account. See Create a Wherobots Account.

The Wherobots CLI, version 1.3.0 or later. See Install Wherobots 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.

Choose a region

Each region has its own My Files. Choose the region before you work with files.

Code page
CLI

Go to the Code page, expand the region, for example AWS US West (Oregon), then expand My Files under it.

Pass --region after my-files:

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

Work with files and folders

List a folder

Code page
CLI

In the tree, expand My Files in your region, then expand the folder you want to see.

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

Code page
CLI

Select the Actions menu (the vertical dots) next to My Files or a folder.
Select New Folder, enter a Folder Name, and click Create.

The folder Actions menu — The folder menu

mkdir creates the folder and any missing parent folders, and prints Created folder projects/2026/q3:

wherobots files my-files mkdir projects/2026/q3

Upload files

Each file can be up to 500 MiB.

Code page
CLI

Select the Actions menu next to My Files or the destination folder.
Select Upload Files and choose one or more files.
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:

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

Code page
CLI

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:

wherobots files my-files download projects/report.csv
wherobots files my-files download projects/report.csv ./backup/

View a file

Code page
CLI

Select the file in the tree. The details panel shows a read-only preview of notebooks (.ipynb) up to 25 MiB, and of text files such as .py, .sql, .md, .csv, .json and .txt up to 1 MiB. Larger files show Too large to preview, and other files show No preview.

A notebook preview in the details panel — A read-only notebook preview in the details panel

wherobots files my-files cat projects/report.csv

Rename a file

Renaming is not available on the Code page. Use the CLI, or rename the file in a notebook. In the CLI, mv renames a file within its folder:

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 Code 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

Code page
CLI

Select the Actions menu next to the file or folder, then select Delete.
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:

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 Runtime

On the Code page, you can open a text file such as .ipynb, .py, .sql, .md, .csv, .txt or .json straight into a new Notebook Runtime.

Select the file in the tree.
Click the Open File icon in the details panel, or select Open File from the file’s Actions menu. The Open in a Notebook Runtime dialog names the region and the path where the file is available in the Notebook Runtime.
Choose the Size and other options if you need to, then click Open. A new Notebook Runtime starts in the file’s region, in a new browser tab, and JupyterLab opens the file when it is ready.

The Open in a Notebook Runtime dialog — Open in a Notebook Runtime

If your browser blocks the new tab, click Open workspace in the message on the Code 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 you used notebooks before My Files, your previous home folder is kept, either as the folder your notebook opens in or as the read-only _legacy_home_backup folder in My Files. See 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.

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 Code page, or upload, rename or delete with the CLI	Code page and CLI	The CLI shows the change immediately. On the Code 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	Code page and CLI	About a minute after the file’s last change
Delete in a notebook	Code page and CLI	About a minute after the delete
Upload in the Code page or the CLI	Notebook	Within a few seconds.
Delete in the Code 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:

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 Use the CLI from an agentic terminal.

If you used notebooks before My Files

If you used Wherobots notebooks before My Files, your notebook opens in one of two layouts. Both keep your previous home folder.

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:
mkdir -p ~/workspace/my-files/projects cp -r ~/projects/. ~/workspace/my-files/projects/

Your notebook opens in My Files

Your previous home folder is the _legacy_home_backup folder in MY FILES, at /home/wherobots/workspace/my-files/_legacy_home_backup in a notebook terminal. It is read-only, so copy the files you want to keep working on out of it into My Files. On the Code page, _legacy_home_backup shows as an empty folder, because its files are reachable only from a notebook.

File browser: open _legacy_home_backup, right-click a file or folder, and select Copy. Open the folder in MY FILES where you want it, right-click an empty area, and select Paste.

Terminal: copy the folder’s contents with cp -r:

mkdir -p ~/workspace/my-files/projects
cp -r ~/workspace/my-files/_legacy_home_backup/projects/. ~/workspace/my-files/projects/

In both layouts, the files you copy appear on the Code page about a minute after the copy finishes.

Limitations

500 MiB per file on the Code 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 Code page.
Meant for notebooks, code and small files. For datasets, use Managed Storage or an S3 storage integration.

Troubleshooting

no such file or folder: <path>

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 <folder>, and pass --region if the file is in another region. For a notebook save, wait about a minute after the last change.

Files is not enabled for my-files in region <region>

Cause: My Files is not available to you in that region.Solution: Try another --region.

file is <N> MB, exceeding 500 MB limit

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 or an S3 storage integration.

HTTP 429 Rate exceeded

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.

A file I saved in a notebook is not on the Code page

Cause: The file is saved. The Code 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.

A folder I deleted came back

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 on the Wherobots CLI page.

Next steps

Jupyter Notebook Management

Find your files and run notebooks in JupyterLab.

Managed Storage

Store datasets for your Organization.

Start here

Notebooks

Editors and AI assistants

VS Code extension

MCP server and agent skills

dbt

Apache Airflow

Storage management

Task schedules

Deployment and monitoring

Before you start

Choose a region

Work with files and folders

List a folder

Create a folder

Upload files

Download a file

View a file

Rename a file

Delete a file or folder

Open a file in a Notebook Runtime

Save your work in My Files

How long changes take

Use the CLI in scripts and agents

Paths

Wait for a notebook’s changes

Agentic terminals

If you used notebooks before My Files

Your notebook opens in your home folder

Your notebook opens in My Files

Limitations

Troubleshooting

Next steps

Jupyter Notebook Management

Managed Storage

​Before you start

​Choose a region

​Work with files and folders

​List a folder

​Create a folder

​Upload files

​Download a file

​View a file

​Rename a file

​Delete a file or folder

​Open a file in a Notebook Runtime

​Save your work in My Files

​How long changes take

​Use the CLI in scripts and agents

​Paths

​Wait for a notebook’s changes

​Agentic terminals

​If you used notebooks before My Files

​Your notebook opens in your home folder

​Your notebook opens in My Files

​Limitations

​Troubleshooting

​Next steps

Jupyter Notebook Management

Managed Storage

Before you start

Choose a region

Work with files and folders

List a folder

Create a folder

Upload files

Download a file

View a file

Rename a file

Delete a file or folder

Open a file in a Notebook Runtime

Save your work in My Files

How long changes take

Use the CLI in scripts and agents

Paths

Wait for a notebook’s changes

Agentic terminals

If you used notebooks before My Files

Your notebook opens in your home folder

Your notebook opens in My Files

Limitations

Troubleshooting

Next steps