Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mesa.dev/llms.txt

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

MesaFS is a virtual filesystem that mounts Mesa repositories as local directories. You can directly read, write, and delete files — all your edits are automatically persisted to back to Mesa. MesaFS is the recommended way to interact with files on Mesa and it is ideal for agents, CI pipelines, and large monorepos where a full clone is impractical.
Mesa is early-stage, beta software. We will not lose or corrupt your data, but you may encounter occasional performance/stability issues.If you run into any issues, we urge you to flag it in Discord.

How it works

MesaFS can be run in two distinct modes: The mode you use is largely dictated by the environment you are working in. When mounting Mesa in a single-tenant sandbox or Linux VM with access to the kernel it often makes sense to use a CLI Mount which registers MesaFS as a FUSE filesystem. If using Mesa in a serverless environment, your multi-tenant application backend, or in a sandbox that doesn’t enable FUSE mounts then you should use an Application Mount. Application mounts are lighterweight, and often have better developer experience. If your agent is only reading and writing to files and you do not need to execute arbitrary binaries or sidecar processes then you should consider using an Application Mount and foregoing a separate sandbox altogether.

Application Mount

Learn how to use MesaFS as an application-level mount.

CLI Mounts

Learn how to use MesaFS as a CLI mount.