The filesystem browser in Chat gives you a visual way to explore and manage files stored in your project. You can view folder hierarchies, perform file operations, and reference files directly in your chat messages using @.
Accessing the filesystem browser
The filesystem browser appears in the right sidebar panel of Chat. To open it, select the Files tab in the SuperAgent panel on the right side of the Chat interface.
View options
The filesystem browser supports two layout modes so you can work in whichever format suits your task.
List view
The default layout displays files and folders in a hierarchical tree structure. This view is useful for navigating deeply nested directories and seeing the full folder structure at a glance.
Grid view
Grid view displays files as icon tiles in a Finder-style layout. Each tile shows the file icon and name, making it easier to visually scan a flat directory with many files.
Switching between views
Use the toggle button in the filesystem browser toolbar to switch between list view and grid view. Your view choice is saved automatically and persists across sessions — the next time you open Chat, the filesystem browser will use the same layout you last selected.
Navigating folders
A breadcrumb trail at the top of the filesystem browser shows your current location in the folder hierarchy. Click any folder name in the breadcrumb to jump directly to that level.
File operations
Right-clicking a file or folder in either view opens a context menu with the following operations:
| Operation | Description |
|---|
| Open | Opens the file for viewing |
| Download | Downloads the file to your local machine |
| Copy file path | Copies the full path of the file to your clipboard |
| Rename | Renames the file or folder inline |
| Delete | Permanently deletes the file or folder |
Delete operations are permanent and cannot be undone.
Referencing files in chat
Files visible in the filesystem browser can be referenced in your chat messages using the @ menu. This is useful when you want an agent to read, process, or act on a specific file.
How to reference a file
- Type @ in the chat input field
- Start typing the file name or path
- Select the file from the results — it shows the file icon, name, and path
- The file path is inserted into your message, and the agent can access the file during its run
Use the filesystem browser to locate a file and copy its path, then paste it into the chat if you prefer not to use the @ search.
