Mesa

Mount Mesa repositories as local directories without cloning. A FUSE-based virtual filesystem for agents, CI pipelines, and large monorepos.

1.0HOW IT WORKS

Your Agent / Tool

cd /mnt/acme/my-workspace

cat README.md

echo "Hello world!" >> README.md

↓

Mesa (FUSE mount)

Smart pre-fetching · Client-side caching

↓

Mesa API

Mesa VCS Engine

Mesa is a FUSE-based virtual filesystem that mounts your Mesa repositories as local directories. Files are progressively materialized with smart pre-fetching and local caching—no full clone required.

Any tool that reads files from the filesystem works out of the box—editors, agents, grep, build tools. No SDK or special integration needed.

Supports macOS (via macFUSE) and Linux. Windows support is on the roadmap.

Read Docs

2.0GETTING STARTED

Install

$ curl -fsSL https://mesa.dev/install.sh | sh

Auto-detects your platform and installs the latest release. Requires macFUSE on macOS.

Mount

$ mesa mount
# Browse any repo as a local directory
$ ls ~/.local/share/mesa/mnt/acme/
my-repo  another-repo  monorepo
$ cat ~/.local/share/mesa/mnt/acme/my-repo/README.md

On first run, Mesa walks you through configuration. Repos appear at the mount point organized by org.

3.0DAEMON MODE

$ mesa mount --daemonize

Run Mesa as a background daemon. Your repos stay mounted and available to any process on the system.

Configuration

Configure Mesa via a TOML config file at ~/.config/mesa/config.toml. Set your mount point, org API keys, cache size limits, and daemon logging options.

4.0CAPABILITIES

No Clone Required

Access any file in any repo without downloading the entire repository. Files are intelligently pre-fetched and cached locally.

Works with Any Tool

Editors, agents, grep, build tools, language servers—anything that reads files works out of the box. No SDK or integration required.

Local Caching

Configurable local cache with size limits. Frequently accessed files are served instantly from disk.

macOS & Linux

Supports macOS (via macFUSE) and Linux (via FUSE). Install in one command and start browsing repos immediately.

5.0USE CASES

Agent Workspaces

Give agents filesystem access to repos without cloning. Point your agent at a mounted directory and let it read code, configs, and docs.

Large Monorepos

Access specific files in massive repos without downloading everything. Only the files you touch are fetched and cached.

CI / Sandbox Workers

Mount repos in ephemeral environments. No git clone step, fine-grained access control.

Ready to get started?

Install Mesa and start browsing repos in seconds.

Read Docs