Skip to main content
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 lighter weight and typically provide a simpler developer experience. If your agent is only reading and writing to files and you do not need to execute arbitrary binaries or run sidecar processes, then you should consider using an Application Mount and foregoing a separate sandbox altogether. In both modes, you can see reads and writes from other mounts on the same change in realtime. See realtime docs for more details.

Application Mount

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

CLI Mounts

Learn how to use MesaFS as a CLI mount.