The file browser

📁 Browse files shows the files on the relay's machine without leaving the conversation: the folder the agent works in, the rest of the machine, and the folder the agent's own session keeps. You use it to see what the agent changed, to open a file, to copy a reference for your next message, and to tidy up. The same browser picks a folder when you start a conversation or change its working folder.

Opening it #

The browser opens as a dialog over the conversation. Its title says which root you are in: Repository Browser, Drives Browser or Session Browser. Close it with × or Escape.

On a desktop the dialog has two panes side by side. The left pane, File tree, shows folders only. The right pane shows the files of the open folder, with a path bar above it. On a phone the two panes sit one above the other, the tree on top. Click a folder in the tree to open it. ⌖ Focus collapses the tree to the open folder. A counter beside it shows how many entries the tree holds, for example 12 nodes in the workspace and 12 entries elsewhere.

List and Icons switch the file pane between rows and cards. Cards show a thumbnail for images.

The three roots #

Three buttons at the left of the toolbar choose what the browser shows.

Which folder the workspace is #

The workspace root is the conversation's working folder. It follows the conversation you have open, and a running session keeps the folder it is really working in. 🗂️ Change CWD in the conversation's ⋯ menu moves it for the next launch of the agent, or at once with 🚀 Set new CWD and (re)launch; see Changing it later. When the working folder changes, the browser drops what it had open and shows the new folder. Typing cd in a chat message does not move the browser.

A Claude Cloud chat has no working folder on your machine and no file browser: the agent works on a clone at Anthropic.

Drives and the session folder #

The drives root reaches the whole machine, not only the working folder. The allow list that limits where a chat may start (workspaceRootAllowList, see Limiting where chats may start) does not limit what you can browse.

The session folder lists the files the agent's provider keeps for this session. You can look at them and open them. In the Session Browser the browser offers only New folder: no Rename or Delete. That is a rule of the page, not of the relay. The same folder, opened through 📀, offers Rename and Delete, and the relay does not refuse them.

The toolbar #

Hidden and Heavy are both off the first time. A hidden name that is also heavy needs both switches. A change takes effect at once and refreshes the tree.

Your browser remembers the filters: Hidden for the workspace, Hidden for the drives and session roots (one setting for both), and Heavy. It does not remember the root, the view or which folders were open; those last while the page stays open, and survive Refresh and closing and reopening the dialog, but not reloading the page.

Opening a file #

Click a file in the file pane to open it in the file viewer. In the folder picker (below) files cannot be opened.

Referencing a file or folder in your message #

Two controls copy a reference to the clipboard, wrapped in backticks. They do not put it into the composer: you paste it into your message yourself.

In the workspace the path is relative to the working folder, such as @folder:src/components. In the drives and session roots it is the full path on the machine. What the agent receives for a reference, and how images are attached, is in File references.

Folders and files #

Added in 0.9.10 You can create folders, rename files and folders, and delete them. This works in the workspace and on the drives. In the session folder the browser offers new folders only.

New folder #

📁+ New folder opens a name field at the top of the file pane. Type the name and press Enter: the folder is created inside the open folder and the browser opens it. Escape cancels. A notice says Folder "name" created. A name that is taken, or that the system refuses, is reported under the field and the field stays open. The button is disabled while nothing can hold a folder, such as the Windows list of drives.

The context menu #

Right-click a folder in the tree or a file in the file pane. On a phone, press and hold. The menu offers:

Rename and Delete are not offered for a root (the working folder, / or a drive), nor for anything in the Session Browser. A folder you rename keeps its place in the tree and stays open.

Delete #

Delete first asks the relay what would go, and the dialog tells you before anything is removed:

For a folder with content, the red 🗑 Delete button stays disabled until you type the folder's name in the field Type the folder name to confirm. Deleting removes the file or folder from the disk; it does not go to a trash.

Names and links #

• A name is one segment: it cannot be empty, . or .., cannot contain / or \, and is at most 255 bytes.
• When the relay runs on Windows, a name also cannot contain < > : " | ? * or control characters, cannot end with a dot or a space, and cannot be a name Windows reserves, such as con or nul.
• Names are compared exactly: a name that is already in the folder is refused with That name is already taken. Changing only the capitals of a name is allowed.
• A link (a symbolic link) is never renamed or deleted: the relay refuses it with Links cannot be changed here. The workspace tree does not list links. On Linux and macOS the drives and session roots do list them, and show a link to a folder as a folder, so you can open and read through one; only the link itself is protected. A path that goes through a link to a folder still reaches the folder behind it. In the workspace, a link that leads outside the working folder is refused as an invalid path.
• A change the operating system does not allow is reported as Permission denied. A refused rename or delete appears as a notice; a refused new folder appears under the name field.

As a folder picker #

The same browser chooses a folder for New chat and for 🗂️ Change CWD: press 📁 next to the path field. The browser opens on the drives root, a bar at the bottom shows the selected folder (or Select a folder…), and ✅ Use this folder as CWD hands it back. The three roots stay available. In this mode files do not open, and Rename and Delete are not offered; 📁+ New folder and 📁 New folder here work, so you can create a project folder and pick it in one go. See The working folder.

Limits #

• The workspace tree loads one folder at a time, when you open it. Hidden and heavy names are left out until you switch them on.
• A folder the relay cannot read opens empty instead of showing an error. Entries it cannot read are left out of the list.
• The session root is empty, not an error, for a Claude or DeepSeek session that has not written any files yet.

By provider #

The browser is the same for every provider that works in a folder on the relay's machine. What differs is the session folder behind 🕵️.