Manage an agent's files on the Workspace tab

The Workspace tab holds the files your agent can read while it works: price lists, style guides, notes, templates for what it writes, and the files it produces itself. Adding a file here is the simplest way to hand an agent reference material without pasting it into a chat. Its instructions and persona live elsewhere, under identity and instructions.

Before you start#

• The agent must have finished setting up. Until then the Workspace tab shows a lock. See finish setting up.

Open the workspace#

Open the agent and click Workspace in the tabs under its name. The Files section lists the files in its workspace, grouped in folders, with each file's size. Use Search files and the type menu above the list to find a file, and Refresh to see files the agent has written since you opened the tab.

1234

Add files#

Upload files

1. Click Upload files (2).
2. Under Upload to, pick the folder the files go into: the top level, a folder that already exists, or New folder…, where you type a name such as notes/2026.
3. Drop files or a folder onto the panel, or click Choose files or Choose a folder.
4. Wait for the note that says how many files were added, and which were skipped and why.

To upload straight into a folder, point at the folder in the list and click its upload button, or drag files from your computer onto the folder or any file inside it. Files dropped on a file outside every folder, or on the strip at the top of the list, land at the top level.

The workspace takes text files, such as .md, .txt, .csv, .json or .yaml, up to 256 KB each; pictures, other binary files and larger files are skipped. A .zip is unpacked, and a folder is copied, both keeping the folders inside them. Hidden files, such as .git or .DS_Store, are left out. A file with the same name as one already in that folder replaces it. Characters other than letters, numbers, dots, dashes and underscores in a name become underscores.

Write a new file

1. Click New file (1).
2. Type a name, such as notes/monday.md. A / makes a folder. A name ending in .md gets a formatted editor; any other name gets a plain one.
3. Type the contents, or leave them empty for a blank file.
4. Click Create file.

Move files and folders#

Drag a file onto a folder in the list to move it there. Dropping it on any file inside a folder moves it into that folder too, and dropping it on the Drop here to move to the top level strip, which shows while you drag, moves it out of every folder. A closed folder opens when you hold a file over it for a moment.

• Drag a folder to move it with everything inside it.
• Tick several files first, then drag one of them, to move them all together.
• A file is never moved onto one with the same name. It stays where it was, and the note under the toolbar names it.

An open file follows its move, and unsaved changes in the editor are kept.

Open, edit and rename a file#

Click a file in the list to open it beside the list.

• Text and code open in an editor. Make your changes and click Save. A Markdown file shows its preview next to the editor. A file larger than 256 KB shows only its beginning and cannot be edited here.
• Pictures and PDFs are shown as they are, read-only, with a Download button. Files larger than 4 MB are not shown; download them instead.
• Other kinds of files have no preview; download them to open them on your own computer.

To rename the open file, click Rename (4), type the new name and click Rename again, or press Escape to cancel.

Download or delete files#

Tick the boxes next to files in the list (or Select all), then:

• Click Download (3) to save them. One file downloads as it is; several download together as a ZIP.
• Click Delete to remove them. A dialog lists the files and asks you to confirm.

To delete the open file, use the Delete button next to Rename.