Skip to main content
Every account has a virtual file system (VFS) where agents store the artifacts they create — CSV exports, charts, markdown reports, PowerPoint decks, and more. The Files page lets you browse, preview, edit, and manage these files alongside anything you upload yourself.
Image

​
File scopes

Files are organized into three scopes:

​
Browsing files

The file explorer has three panels:
  • Folder tree (left) — Navigate the directory structure. On mobile this slides in from the left edge.
  • File list (center) — Shows files in the selected folder, including an Owner column for shared items. Click a file to preview it. The preview refreshes automatically when the file is saved.
  • File info (right) — Displays metadata, a preview, and version history for the selected file. On mobile this slides in from the right edge.

​
Keyboard shortcuts

​
Context menu

Right-click (or long-press on mobile) any file or folder for an actions menu with Edit, Download, Copy file path, Share, Upload, Rename, Copy to folder, and Delete. Deleting a folder correctly removes it from the tree sidebar. Copy file path copies the file’s VFS path (for example, /mnt/shared/reports/q4-summary.md) to your clipboard, so you can paste it directly into a skill, a persona’s agent statement, or a chat message. A toast confirms the copy.

​
Recently Deleted

If you delete a file or folder from My Files and need it back, open Recently Deleted from the file explorer toolbar. The view lists items deleted from the folder you’re currently viewing and lets you restore them in place.
1

Open the folder the item was deleted from

Recently Deleted is scoped to your current location. The dialog header shows the folder path (for example, My Files / reports) so you know which trash you’re looking at.
2

Click Recently Deleted in the toolbar

A dialog opens with deleted files and folders, when they were removed, and their size.
3

Click Restore

The item is restored to its original path. Folders restore the full nested tree. If a file already exists at the original path, the restore is skipped so it does not overwrite current content.
Recently Deleted is only available for My Files. It does not apply to Session files or External sources (OneDrive, SharePoint, Google Drive, or local folders) — those are managed by the upstream provider.

​
Uploading files

You can upload files in several ways:
  • Drag and drop onto the file list.
  • Click Upload in the toolbar.
  • In chat, click the paperclip icon next to the message input and pick Upload file.
The file explorer and chat share a single upload allowlist, so anything you can drag into the Files page also works as a chat attachment. Each message’s combined upload size is capped at 25 MB. Supported formats include PDFs, Word documents (.doc, .docx, .docm, .odt, .rtf), spreadsheets (.xls, .xlsx, .xlsm, .ods, CSV, TSV), presentations (.ppt, .pptx, .pptm, .odp), images (PNG, JPEG, WebP, GIF, SVG), text and markdown (.txt, .md, .mdx, .log), data and config files (JSON, JSON Lines, YAML, XML, TOML, .env), and common source code (Python, JavaScript/TypeScript, SQL, HTML/CSS, shell, Ruby, Java, C/C++, Go, Rust, PHP). See Supported file formats for the full list.

​
Copy and overwrite

When you copy a file into a folder that already has a file with the same name, a confirmation dialog asks whether to overwrite. Long file names wrap neatly in the warning text.

​
Creating folders

Click New Folder in the toolbar to create a folder inside the current directory. Drag files between folders to reorganize.

​
File previews

Image
The file explorer renders previews for most common formats:
  • Markdown — Rendered with full formatting, including LaTeX math, VFS links, file cards, and inline images. YAML front matter is stripped before preview.
  • CSV — A lightweight read-only table (CsvTable) for quick inspection, capped at 100 rows for large files. Download for the full dataset.
  • Code files — Syntax-highlighted for JSON, Python, TypeScript, SQL, XML, CSS, Markdown, YAML, and more.
  • Images — Displayed inline.
  • PDF — Rendered in-browser.
  • Large files (over 100 KB) — Opened in a read-only preview with a truncation notice.

​
Version history

Each file tracks its version history. Open the file info panel and scroll to Versions to see when the file was created or modified, and by whom.

​
Reverting to a previous version

From the Versions list, click Revert on any past version. A confirmation dialog asks you to confirm; after accepting, the file contents are restored to that version and a new version entry is added.

​
Editing files

Click Edit in the file info panel to open the built-in editor. Code files show syntax highlighting. Press ⌘Enter / Ctrl+Enter to save and close.

​
AI-assisted markdown editing

For markdown files, click Edit with AI to open a chat-based editing interface. Describe the changes you want in natural language and the agent applies them. A track-changes preview highlights exactly what was added, modified, or removed with color-coded diffs before you accept. The track-changes view uses theme-aware colors so it stays legible in dark mode.

​
Agent-driven file editing

Agents can read, search, edit, and compare files during a conversation: Moves and copies follow the same rules as file explorer actions: agents can write into My Files, Shared, the active Session, and Local folder mounts, but not into read-only OneDrive, SharePoint, or Google Drive mounts. Folders are not supported — agents move or copy one file at a time. When an agent edits a file, the chat shows an inline diff card with syntax-colored added/removed lines, the file icon, and a link to open the full file.

​
@ file mentions in chat

You can reference any file in a chat message by typing @ in the message input.
1

Type @

After a space or at the beginning of a line, type the @ character. A dropdown appears.
2

Search for a file

Start typing the file name. The dropdown uses fuzzy search across My Files, Shared, and Session files, and prioritizes recent and relevant matches. Files with auto-generated UUID/GUID names are hidden to keep the list readable.
3

Select a file

Click the file or press Enter. The file’s VFS reference is inserted into your message and rendered as a clickable pill.
4

Send your message

The agent receives the file reference and can read, analyze, edit, or transform the file as part of its response.
File mentions appear as clickable pills in your messages. Click a pill in chat to download the referenced file or open it in the file explorer.
The @ dropdown never clips the first row when the list is taller than the viewport, and its rendering is optimized so the list stays smooth even with hundreds of files.

​
File references in agent responses

When an agent creates or references a file, the path appears as a clickable link or a file card in the chat. Clicking it opens the file in the file explorer. Agents use the same VFS path format (/mnt/current_session/chart.svg, /mnt/shared/report.csv) so you always know where a file lives.