Skip to main content
By default, an agent starts each run from a clean slate. Agent Filesystem changes that: when it’s enabled, the agent’s workspace persists between runs, so files, notes, and tool state carry forward instead of resetting every time.
Agent Filesystem is in Beta.

​
Viewing Files

The files in an agent’s workspace are viewable directly in the UI, where you can browse the workspace, preview files, and download them.

​
Persisting Files Across Runs

Turning on Agent Filesystem keeps an agent’s workspace between runs. This is useful when an agent should:
  • Build on prior work instead of starting over each run
  • Reuse reference files, lookup tables, or templates you upload once
  • Keep packages or scripts it installed available for later runs

​
Enabling It

1

Open the agent

Go to Agents and open the agent you want to update.
2

Turn on Agent Filesystem

Find the Agent Filesystem card and flip the toggle to On.On the agents and detections list pages, you can also use Learn more on the Agent Filesystem banner to enable it for several agents at once.
3

Manage the files

Once enabled, the agent gets a persistent workspace panel where you can browse, upload, download, and delete files.

​
Managing the Persistent Workspace

From the workspace panel you can:
  • Upload files with the Upload button or by dragging them onto the panel
  • Download any file, or a whole folder as a zip
  • Delete files and folders you no longer need
  • Preview text, markdown, and image files without downloading
Files you upload and files the agent creates share the same workspace, so the agent can pick up where it left off.
Use the persistent workspace for files that should stick around, like reference data or reusable scripts. Keep large, run-specific scratch output (such as raw logs) out of it so the workspace stays tidy.

​
Agent Filesystem vs File Attachments

These are related but separate:
Use this for…Agent FilesystemFile Attachments
Files the agent creates during a runYesNo
Files that carry across runsYes (when enabled)No
Files you upload to a single chat messageNoYes
See File Attachments for uploading files directly to a chat message.