Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mulerun.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Overview

MuleRun Pages is the website-hosting service built into the MuleRun platform. Without provisioning servers, domains, CDN, or databases, users (or the super agent acting on their behalf) can publish a static site—or a dynamic one with forms, data storage, and third-party integrations—to the public internet, accessible via a platform-assigned default domain (e.g., xxx.mule.page) or the user’s own domain. Pages offers two entry points:                                                                                                          
  • The “Pages” entry in MuleRun Chat’s left navigation: Lists every site under the account as cards, each showing a preview thumbnail, status, current version, domain link, and a management menu (see Managing Pages below).
  • Direct publishing by the super agent in chat: The user describes a need, and the agent handles creation and publishing without ever leaving chat.
Capabilities:
  • One-click publishing of pages or apps with forms, data, and third-party service integrations.
  • Version history per site—roll back to any previous version with one click if a new release isn’t right.
  • Auto-assigned *.mule.page default domain; paid users can bind their own domain by following the DNS prompts, with certificates and CDN provisioned automatically.
  • An optional dedicated database for dynamic pages—reads and writes happen automatically, with no connection management needed.
  • Per-site monthly request and bandwidth quotas controlled by subscription tier, with usage shown on each card.
  • Basic management actions like rename and delete.

Target Users

  • Individual users — Applicable. One-off publishing of portfolios, event sign-up forms, small tools, or AI app demos; no need to buy domains, configure servers, or apply for SSL certificates.
  • Team members — Applicable. Publish internal or external pages under the team subscription; each member has their own Pages quota and they don’t compete.
  • Team admins — Partially applicable. Purchase a higher tier in the subscription center for the team. Each page is currently managed by its creator individually—Pages does not yet offer a team-aggregated panel of all members’ pages.

Use Cases

  • AI mini-apps built by the agent — Describe the need in chat; the agent prepares the content, creates a dynamic page via Pages, and returns an accessible link.
    • Temporary event landing pages — The agent creates and publishes a static page; you get a mule.page link to share within seconds. Delete from the card menu when the event ends.
    • Collecting and storing form data — The agent creates a dynamic page with a database; visitor submissions are saved automatically. The agent can also help you view table names and contents.
    • Bind a custom domain — From a card’s menu, click “Custom Domain”, enter the domain, and follow the DNS prompts. The platform issues a certificate and takes over traffic automatically.
    • Invite-only beta pages — Enable “Access Code” from the card menu; visitors without the code can’t see the content. Once a visitor passes, they usually skip re-entry for a while.
    • One-click rollback if a release goes wrong — Have the agent publish a new version; if something breaks, switch back to the previous version with one click.

Quick Start

The shortest path: upload a local file to Drive and have the agent read it in chat.   1. In MuleRun chat’s left navigation, click “Drive” to open the Drive entry.   2. Click “Upload File” in the upper right and choose one or more local files from the system dialog.   3. An upload panel appears in the lower right, showing per-file progress; once finished, the files appear in the current directory’s list.   4. Back in the chat input box, click the “Add content (+)” menu → “From Drive”.   5. In the Drive file picker, find the file you just uploaded, check it, and click “Attach”.   6. The file appears as an attachment in the input box; send the message and the agent can read its content. When done, the file should appear in the Drive list, and the chat input’s attachment area should show a thumbnail summary of it. If uploads stall on the progress bar or report failure, see the corresponding item under FAQs below.

Detailed Guide

Adding Files

Upload Local Files In the current Drive directory, click “Upload File” and choose one or more local files from the system dialog. An upload panel appears in the lower right:
  • Files upload as a queue, up to 3 concurrent uploads, each showing its own progress.
  • Larger single files are automatically split into chunks; progress accumulates as parts complete.
  • The progress panel can be manually closed or fully cleared.
  • When all uploads finish, new files appear in the current directory.
Constraints:
  • Filenames cannot contain / or \; duplicate names within the same directory are not allowed.
  • Empty files cannot be uploaded.
  • If the network drops or the browser is closed mid-upload, the current upload session is canceled, and unfinished files need to be re-selected.
Create a Folder Click “New Folder” in the current Drive directory, enter a name in the dialog, and confirm. The folder appears in the directory list. Constraint: Folder names cannot contain / or \.

Managing Files

In the Drive entry, you can do the following with files and folders under your account:
  • Browse the directory tree, sort by modified time, and search by filename within the current directory in real time.
  • Preview images, video, audio, PDF, Markdown, code, CSV, HTML, and Word / Excel / PowerPoint online.
  • Download individual files.
  • Rename files or folders.
  • Attach existing Drive files to the agent from the chat input box.
  • View the account’s current used / total storage at the top of the page, and open the subscription upgrade window directly via “Get more spaces” or “Manage Plan” on the storage bar.
Note about Agent Workspace. Agent Workspace under the account root is a platform-maintained system folder, organized in two levels (Agent name / session name) and holding files produced by agent tasks. The folder itself cannot be renamed or deleted (grayed out in the menu, labeled “system folder”), but the files inside can be individually previewed, downloaded, renamed, and deleted.

Operation Behavior

Browse / locate Use breadcrumbs, sort by the modified-time column, and filter via the current-directory search box. Drive’s search filters by filename only within the current directory in real time, and the scope changes when you switch directories. The “From Drive” picker in the chat input has a separate account-wide search that searches by filename across directories (files only—folders are not shown). Preview Click a filename or file icon in the list. Unsupported formats show a “cannot preview” notice—download instead. Office documents open in online editing mode and auto-save back to Drive during editing. Download Click “Download” in the file row. The browser starts downloading immediately, keeping the original filename from Drive. Folders currently cannot be downloaded as a single packed archive. Rename Open the file/folder row menu → “Rename”. This changes only the name, not the parent directory. The new name cannot contain / or \. Attach in chat Chat input “Add content (+)”“From Drive”. Each message can attach up to 20 files, max 500 MB each. For larger needs, zip them, upload the zip to Drive, then attach the zip. Currently Unsupported
  • Drive does not provide external share-link generation. To send files to outside guests, download them locally first and share via other channels.
  • Bulk-selecting multiple files or folders for batch operations is not supported—operations must be done one at a time.

Deleting Files

“Removing a file from Drive” falls into two cases:   1. User-initiated deletion — permanent and unrecoverable.   2. Cannot add new files when out of space — existing files remain fully intact, but new writes are rejected. User-Initiated Deletion Delete a single file — From the file row’s menu, click “Delete” and confirm. The file is removed from Drive and its storage is freed immediately. Not recoverable. Delete a folder — From the folder row’s menu, click “Delete” and confirm. The folder and all child files and subfolders are removed together; storage is freed immediately. Not recoverable. Important. Deleting a folder also deletes every file and subfolder inside it—preview the contents before confirming. Drive has no trash bin and no automatic backups; deletions cannot be undone. Cannot Add New Files When Out of Space Upload rejected   - Trigger: Used space plus the pending file’s size exceeds the subscription tier’s storage quota.   - Effect: The upload errors with “out of space”; existing files, folders, and Agent Workspace are fully preserved.   - Recover: Delete some files to free space, or upgrade the subscription.   Over-quota after downgrade   - Trigger: After downgrading from a higher tier to a lower one, the account’s used space exceeds the new tier’s quota.   - Effect: Existing files remain readable, downloadable, and deletable; new files cannot be uploaded, and the agent’s writes during tasks will also fail.   - Recover: Delete some files to bring total usage under the new tier, or upgrade back to the original tier.

Plans, Quotas, and Limits

Drive is available on all tiers (Free / Plus / Super / Pro / Team Plus). Common to all tiers:
  • Per-file size limit: 10 GB
  • Folder depth limit: 20 levels
  • Online Office editing: supported
  • Attaching Drive files from the chat input: supported
Account storage quota by tier:
TierStorage
Free10 GB
Plus100 GB
Super100 GB
Pro1 TB
Team Plus100 GB per member
Drive does not consume Credits—it’s primarily limited by the storage quota of the current tier. Once usage hits the limit, no new files can be uploaded; existing files are unaffected.

FAQs

Q: My upload is stuck on the progress bar or fails with “out of space”—what’s going on? A: First check the account’s current used space. If it’s near the subscription tier’s limit, free up space by deleting files you no longer need, or upgrade the subscription to raise the quota. If a single file exceeds the per-file size limit, split or compress it before re-uploading. Q: I deleted a file or folder by mistake—can I get it back? A: No. Drive has no trash bin and keeps no backups; after the second confirmation, deletion permanently frees the storage. For important materials, download a local copy first as a backup. Folder deletion wipes out everything inside—expand and review before confirming. Q: What does the “Source” column show for an uploaded file in the Drive list? A: It marks who wrote the file. Inside Agent Workspace, it shows the corresponding Agent’s name. Outside the workspace, files you upload yourself show “Me” (written by you); ”—” is shown when there’s no source record.