Skip to main content
A FUSE mount shows a VFS as a folder on the machine running Mirage, so editors, language servers and scripts use it like any other folder, even when the data lives in S3 or another service. Mount from your Python or TypeScript app, or through the CLI. To mount a workspace from another machine, use SSHFS.

Support

A browser cannot mount a folder; use Mirage’s shell and file APIs there.

Set up

1

Install FUSE for your OS

Follow the Linux, macOS or Windows guide.
2

Install your SDK's FUSE binding

Follow the Python or TypeScript guide.

Try it with the CLI

Set backend: fuse and a local folder on a mount:
workspace.yaml
Write a file through Mirage, then read it from the folder:
This prints hello mirage. mirage workspace delete demo unmounts the folder.
  • Replace RAM with any supported VFS to expose your own data.
  • The folder follows the mount’s mode: a read mount cannot be written.
  • A mount set up this way is not tied to an agent session or profile.