Filesystem
How Do Browser's virtual filesystem works, and how to use it to manage files.
Do Browser has a built-in virtual filesystem. It lets the AI agent read and write files, and gives you a place to store data, scripts, skills, and anything else you're working with.
The filesystem persists across sessions — files you create today will still be there tomorrow. Under the hood, it's backed by IndexedDB in the browser, so everything stays local to your machine.
Accessing the File Explorer
To browse your files, open the Do Browser side panel and switch to the Files tab. You'll see a tree view of all your files and folders.
From the file explorer you can:
- Browse and search — Navigate the file tree or use the search bar to find files.
- Create files and folders — Right-click in the file explorer to create new files or folders.
- Import files — Click the import button to add files or folders from your computer, or drag and drop them directly into the panel.
- Open and edit — Double-click a file to preview it, or right-click and choose Edit to open it in the built-in editor.
- Download — Right-click any file or folder and choose Download. Folders are downloaded as a zip file.
- Rename and delete — Right-click for options, or use keyboard shortcuts (F2 to rename, Delete to remove).
Directory Structure
The filesystem has a few top-level directories:
| Path | Description |
|---|---|
/workspace | Your personal workspace. Files the agent creates, data you import, and anything else you're working with goes here. |
/sys | System files bundled with Do Browser. These are read-only. |
/workspace — Your Space
This is where most of your files live. When the agent saves a report, creates a script, or downloads data, it goes into /workspace. You can organize it however you like — create subdirectories, move files around, whatever works for you.
Your custom skills are stored at /workspace/skills/.
/sys — System Files
The /sys directory contains files bundled with Do Browser, like the built-in skills. These are read-only — you can browse and read them, but you can't modify or delete them.
Built-in skills live at /sys/skills/. If you want to customize a built-in skill, create your own version in /workspace/skills/ with the same name and it will take priority.
What You Can Use the Filesystem For
- Saving output — The agent can save reports, scraped data, generated code, or any other output to
/workspaceso you can download it later. - Importing data — Drag files into the file explorer to make them available to the agent. Need the agent to process a CSV or read a config file? Just drop it in.
- Organizing skills — Create and manage custom skills in
/workspace/skills/. - Running scripts — The agent can create and execute scripts stored in the filesystem.
Opening Files in the Browser
The agent can open files from the filesystem directly in a browser tab using the open command. This is useful for previewing HTML files, viewing images, or checking generated output. Local file imports (CSS, images) are resolved automatically.
Common Questions
"Where do files go when the agent creates them?"
By default, the agent saves files to /workspace. You can ask it to save to a specific location, or move files around afterward.
"Are my files stored in the cloud?" No. Everything in the filesystem is stored locally in your browser using IndexedDB. Nothing is uploaded to any server.
"What happens if I clear my browser data?"
Clearing browser data will delete the virtual filesystem, including everything in /workspace.
Still have questions? Reach out at sawyer@dobrowser.io.