Buda LogoBuda

Drive Tab

Browse, upload, and manage files in your Agent's private workspace from the Drive tab.

Drive Tab

The Drive tab gives you a full file browser inside the Agent Workspace. Every Agent has its own private Drive — a persistent file system that the Agent can read from and write to during task execution.

What is Drive?

Drive is the Agent's knowledge base and working directory combined. It stores:

  • Documents you upload as reference material
  • Files the Agent generates during tasks
  • Code, configs, and data the Agent works with
  • Outputs from terminal commands and browser automation

Files in Drive persist across sessions. The Agent can access them at any time without re-uploading.

The Drive tab shows a folder tree on the left and a file preview on the right.

  • Click a folder to expand it
  • Click a file to preview its contents
  • Double-click a file to open it in the full editor
  • Use the breadcrumb bar at the top to navigate back up the tree

Uploading files

Drag and drop files directly into the Drive tab, or click the Upload button in the toolbar. Supported formats include:

  • Documents: PDF, DOCX, TXT, MD
  • Code: any text-based format
  • Images: PNG, JPG, WEBP, SVG
  • Data: CSV, JSON, XLSX

Large files are chunked automatically. Upload progress is shown inline.

Creating files and folders

Click the New File or New Folder button in the toolbar. Files created here are immediately available to the Agent in its next task.

Editing files

Click any text file to open it in the inline editor. Changes are saved automatically. The Agent will see the updated content the next time it reads the file.

Deleting files

Right-click a file or folder and select Delete. Deletion is permanent — there is no trash.

How the Agent uses Drive

When you start a session, the Agent's working directory is set to its Drive root. Any file the Agent creates with a terminal command or code execution lands in Drive automatically.

You can reference Drive files in your messages:

Please summarize the file at /reports/q1-2024.pdf

The Agent will locate and read the file without any extra setup.

Searching files

Use the search bar at the top of the Drive tab to find files by name. Full-text search across file contents is available for text-based files.

On this page