Virtual Filesystem

Mount Mesa repos as a local filesystem. Your agents get familiar fs APIs while Mesa handles versioning, sync, and persistence behind the scenes.

HOW IT WORKS

Your Agent

fs.writeFile("src/app.py", code)

fs.readFile("config.json")

fs.mkdir("components")

↓

Mesa VFS

POSIX interface · Auto-checkpoint · Sync

↓

Storage Layer

GitS3

The Mesa Virtual Filesystem (VFS) provides a POSIX-compatible interface that any language or framework can use. Write files with standard fs calls, and Mesa automatically versions every change.

No SDK required in your agent code. Just mount and use standard filesystem operations.

VFS Docs Get Started

CODE EXAMPLES

Mount Setup (TypeScript)

import { Mesa } from "@mesadev/sdk";

const mesa = new Mesa();
const repo = await mesa.repos.get("my-app");

// Mount the repo as a local filesystem
const mount = await repo.mount("/workspace");

// Your agent uses familiar fs APIs
fs.writeFile("/workspace/src/app.py", code);
fs.readFile("/workspace/config.json");
fs.mkdir("/workspace/components");

// Changes are automatically versioned
// Checkpoints happen on every write

Agent Code (Python)

# Your agent code - no Mesa SDK needed
import os

# Write files naturally
with open("/workspace/main.py", "w") as f:
    f.write(generated_code)

# Read existing files
config = open("/workspace/config.json").read()

# Create directories
os.makedirs("/workspace/components", exist_ok=True)

# Everything is automatically versioned

CAPABILITIES

POSIX-Compatible Interface

Standard filesystem operations work out of the box. read, write, mkdir, readdir, stat—everything your agent expects.

Automatic Checkpointing

Every write creates a checkpoint. Roll back to any point in time, or branch from any checkpoint to explore alternatives.

Works with Any Language

Python, JavaScript, Go, Rust—any language that can do file I/O works with Mesa VFS. No SDK required in your agent code.

Zero Configuration

Mount and go. No config files, no setup scripts. The VFS handles sync, persistence, and versioning automatically.

USE CASES

Sandboxed Execution

Run agent-generated code in isolated environments with full filesystem access, backed by Mesa versioning.

Parallel Exploration

Branch the filesystem to explore multiple approaches simultaneously. Merge the best results back.

Checkpoint & Resume

Save agent state at any point. Resume from checkpoints after failures or to retry with different parameters.

Ready to get started?

Start building with Mesa today. Free tier available.

Read VFS Documentation Get Started Free