Drive

​

Overview

MuleRun Drive is the cloud file space built into the MuleRun platform. It lets users (or the super agent acting on their behalf) gather everything into a single directory tree—files produced during tasks, reference materials for the agent, and personal documents kept long-term—and manage them either directly from the entry on the left side of chat, or via the agent in conversation. Drive offers two entry points:

• The “Drive” entry in MuleRun Chat’s left navigation: Pinned by default in the sidebar’s tools area. Once opened, it lists all files and subfolders in the current directory in a table view, along with a search box, an upload button, a new-folder button, and the account’s current storage usage.
• Read/write by the super agent during chat: Users can attach Drive files to messages so the agent can read them; files newly generated by the agent during task execution automatically land in the Agent Workspace directory, viewable by going back to the Drive entry.

Drive’s capabilities include:

• Browse all files and folders under the account, sorted by modified time (newest first) by default—click column headers to toggle ascending/descending—with instant filename search within the current directory.
• Upload local files of any type (large files are automatically split into multiple chunks for upload), or create empty folders to organize materials.
• Online preview of common formats: images, video, audio, PDF, Markdown, code, CSV, HTML, and Word / Excel / PowerPoint (Office documents support online editing and auto-save back to Drive).
• Download individual files to local.
• Rename and delete files or folders.
• Click “From Drive” in the chat input box to attach an existing Drive file directly to the current message and send it to the agent.

​

Target Users

​

Use Cases

• Provide source materials to the agent — Upload local documents, images, and spreadsheets to Drive; click “From Drive” in the chat input bar to attach files to a message, and the agent can read them.
• Store agent task outputs — After a task ends, return to the Drive entry and navigate to the corresponding Agent / session directory under Agent Workspace to browse, preview, or download all files generated by the task.
• Review a spreadsheet online — Click a file name in Drive to open the preview window; Word / Excel / PowerPoint files open directly in online editing mode, with changes auto-saved back to Drive.
• Organize long-term materials — Create folders to categorize contracts, design drafts, and presentation materials; sort by modification time to quickly locate recently edited files.
• Reuse the same attachment multiple times — Upload once to Drive; whenever it needs to be sent to the agent later, just select it from Drive—no need to re-upload.
• Feed agent outputs back into the next task — Attach files generated by the agent’s previous task (located in the workspace directory) in the chat input bar, so the next round of agent work can build on them.

​

Quick Start

The shortest path to “upload a local file to Drive and let the agent read it in chat”:   1. Click Drive in the left navigation of MuleRun chat to enter the Drive page.   2. Click Upload File in the upper-right corner; select one or more local files from the pop-up system dialog.   3. An upload panel appears in the lower-right, showing progress for each file. Once uploads finish, files appear in the current directory’s list.   4. Return to the chat input bar, click the Add Content (+) menu, and choose From Drive.   5. In the Drive file selection window, find the file you just uploaded, check it, and click Attach.   6. The file appears as an attachment in the input bar—send the message, and the agent can read its contents. Once complete, the Drive list should show the successfully uploaded file, and the chat input’s attachment area should display the file’s preview info. If the upload stays stuck on the progress bar or shows a failure, refer to the corresponding entry in the FAQs below.

​

Detailed Guide

1. Add Files Upload Local Files   Steps:   1. Click Upload File in the current Drive directory and select one or more local files from the system dialog—an upload panel appears in the lower-right.   2. Multiple files upload in a queue, with up to 3 uploading concurrently; progress is shown for each in the list. The progress panel can be manually closed or fully cleared.   3. Large individual files are automatically split into chunks for upload, with progress accumulating as parts complete.   4. Once all files finish uploading, they appear in the current directory’s list. Constraints:

• Single filenames cannot contain / or \ characters; duplicate names are not allowed in the same directory.
• Empty files cannot be uploaded.
• If the network is interrupted or the browser is closed during upload, the current upload session is canceled, and unfinished files must be reselected for upload.

Create New Folder   1. Click New Folder in the current Drive directory—a dialog pops up to enter a folder name.       2. Enter a name and confirm—the folder appears in the current directory’s list. Constraint: Folder names cannot contain / or \ characters. 2. Manage Files In the Drive entry, you can perform the following on files and folders in your account:  

• Browse by directory tree, sort by modification time, and search by filename in the current directory instantly.
• Online preview for images, videos, audio, PDF, Markdown, code, CSV, HTML, and Word / Excel / PowerPoint.
• Download individual files.
• Rename files or folders.
• Attach existing Drive files in the chat input bar to send to the agent.
• View storage usage at the top of the page (used / total); click Get more spaces or Manage Plan on the storage bar to open the subscription upgrade window directly.

Note: The Agent Workspace folder at the account root is a platform-maintained system folder, organized in two levels by “Agent Name / Session Name” to hold files generated by agent tasks. This folder itself cannot be renamed or deleted (shown grayed-out in menus with a “System Folder” label), but files within it can be previewed, downloaded, renamed, or deleted individually. Specific behaviors of each operation:

• Browse and locate — Use breadcrumbs, modification-time column sorting, and the current-directory search box. Drive’s search filters instantly by filename within the current directory only, and changes scope when switching directories. The “From Drive” picker in the chat input bar has a separate account-wide search that searches by filename across all Drive directories (files only, no folders shown).
• Preview — Click a file name or icon in the list. Unsupported formats prompt that preview is unavailable—download instead. Office documents open in online editing mode and auto-save back to Drive during editing.
• Download — Click Download on a file row; the browser starts downloading immediately, preserving the original filename from Drive. Bulk-download of folders is not currently supported.
• Rename — Click Rename in the file / folder row menu. This only changes the name, not the directory location; new names cannot contain / or \ characters.
• Attach in chat — Use Add Content (+) → From Drive in the chat input bar. Each message can attach up to 20 files, max 500 MB each. For larger needs, package files as a zip, upload to Drive, and attach the zip.

Currently unsupported operations:

• Drive does not currently offer generating external sharing links—when files need to be sent to external visitors, download them locally first and share via other channels.
• Batch selection of multiple files or folders for unified operations is not supported; operations must be performed one at a time.

3. Delete Files “Removing files from Drive” falls into two cases: active deletion by the user (permanent and unrecoverable), and unable to add new files when space is low (existing files are preserved, but new writes are rejected). Active Deletion:  

• Delete a single file — Click Delete in the file row menu and confirm twice. The file is removed from Drive and its storage space is freed immediately. Not recoverable.
• Delete a folder — Click Delete in the folder row menu and confirm twice. The folder and all its sub-files and subfolders are removed together, with storage space freed immediately. Not recoverable.

Important constraint: Deleting a folder also deletes all files and subfolders within it—before confirming, preview to ensure no materials still need to be kept. Drive does not provide a recycle bin or automatic backup; deletions cannot be undone. Unable to Add New Files When Space Is Low:

• Upload rejected — Triggered when used space plus the pending file size exceeds the subscription tier’s storage quota. The upload task errors out with “insufficient space”; existing files, folders, and the agent workspace are fully preserved. Resolve by actively deleting some files to free space, or upgrading the subscription.
• Over-quota after downgrade — Triggered when downgrading from a higher tier to a lower one and the account’s used space exceeds the new tier’s storage quota. Existing files remain readable, downloadable, and deletable, but new files cannot be uploaded, and agent attempts to write during tasks will also fail. Resolve by deleting some files to bring total usage below the new tier, or upgrading back to the original tier.

​

Plans, Quotas, and Limits

Drive is available on all tiers (Free / Plus / Super / Pro / Team Plus). Drive does not consume Credits; it’s primarily limited by the storage quota of your tier. Once usage hits the limit, new files cannot be uploaded, but existing files are not affected.FAQs

​

FAQs

Q: My upload is stuck on the progress bar or shows “insufficient space”—what should I do? A: First, check your account’s current used space. If it’s near the subscription tier’s limit, you can free up space by deleting files no longer needed, or upgrade the subscription to expand the quota. If a single file exceeds the per-file limit, split or compress it before uploading. Q: I accidentally deleted a file or folder—can I recover it? A: No. Drive has no recycle bin and does not retain backups; deletion permanently frees the space after two confirmations. For important materials, download a local copy before deleting. In particular, deleting a folder clears everything inside it—before confirming, expand and double-check. Q: What does the “Source” column in the Drive list mean for an uploaded file? A: It indicates who wrote the file—within the Agent Workspace directory, it shows the corresponding Agent name. Outside the workspace, files uploaded by regular users themselves show Me (indicating self-written), and — is shown when there is no source record.