Mirage · Unified Virtual Filesystem for AI Agents | StruktomirageA Unified Virtual Filesystem Workspace<br>A virtualization layer where AI agents reach every backend through one virtual filesystem and bash.<br>New·Read the launch announcement→Read the docs<br>TypeScriptPython<br>npm install @struktoai/mirage-node # Node, servers, CLIs<br>npm install @struktoai/mirage-browser # Browser & edge<br>npm install @struktoai/mirage-agents # OpenAI / Vercel AI / LangChain / Mastra<br>import { Workspace, RAMResource, S3Resource } from "@struktoai/mirage-node";
// Mount resources side-by-side as one virtual filesystem<br>const ws = new Workspace({<br>"/data": new RAMResource(),<br>"/s3": new S3Resource({ bucket: "my-bucket" }),<br>});
// Read, write, and pipe across services with bash<br>await ws.execute("cp /s3/report.csv /data/report.csv");<br>const { stdout } = await ws.execute("grep alert /s3/log.jsonl | wc -l");
// Snapshot and clone like git<br>ws.snapshot("demo.tar");
Capabilities<br>Polymorphic<br>Bash on Every Format<br>Mirage makes standard bash tools work on every format. cat, grep, head, and wc parse .parquet, .csv, .json, .mp3, .wav, .h5, and more.
Heterogeneous<br>Pipe Across Systems<br>Mirage pipes one bash command across heterogeneous backends. Stitch S3, Google Drive, GitHub, Slack, Postgres, and Redis with Unix-like pipes.
Versioned<br>Snapshot & Rollback<br>Mirage versions workspaces like git. Snapshot at any step, clone into parallel runs, and roll back to any prior version with a single API call.
Cached<br>Two-Layer Cache<br>Mirage caches repeated reads in a two-layer index and file cache. Calls to S3, Drive, or Slack collapse into local lookups, so agent loops stay fast and cheap.
Portable<br>Workspace as a Tar<br>Mirage workspaces are portable as a single .tar. The entire mounted state travels with the file, so agent runs hop across hosts without restart.
Embeddable<br>Drop into Your Stack<br>Mirage drops directly into your stack. Embed a Workspace inside FastAPI, Express, or browser apps, and wire into OpenAI Agents SDK, Vercel AI SDK, LangChain, and other agent frameworks.
Python & TypeScript SDKs·Browser support·Snapshot & clone<br>Mirage is a virtualization layer for AI agents, mounting data sources, services, and tools as one virtual filesystem with a bash interface. Embed a workspace inside FastAPI, Express, browser apps, or async runtime. Snapshot and clone workspaces like git to move agent runs without restarting systems.
Read the docsHow it works<br>Mountable resources<br>Amazon S3<br>Google Cloud StorageGoogle Cloud Storage<br>CloudflareCloudflare R2<br>SupabaseSupabase<br>Google DriveGoogle Drive<br>Google DocsGoogle Docs<br>Google SheetsGoogle Sheets<br>GmailGmail<br>GitHubGitHub<br>LinearLinear<br>NotionNotion<br>TrelloTrello<br>Slack<br>DiscordDiscord<br>TelegramTelegram<br>MongoDBMongoDB<br>RedisRedis<br>PostgreSQLPostgres<br>Amazon S3<br>Google Cloud StorageGoogle Cloud Storage<br>CloudflareCloudflare R2<br>SupabaseSupabase<br>Google DriveGoogle Drive<br>Google DocsGoogle Docs<br>Google SheetsGoogle Sheets<br>GmailGmail<br>GitHubGitHub<br>LinearLinear<br>NotionNotion<br>TrelloTrello<br>Slack<br>DiscordDiscord<br>TelegramTelegram<br>MongoDBMongoDB<br>RedisRedis<br>PostgreSQLPostgres
AI agent frameworks<br>OpenAI Agents SDK<br>VercelVercel AI SDK<br>LangChainLangChain<br>PydanticPydantic AI<br>CAMEL<br>Mastra<br>OpenHands<br>AnthropicClaude Code<br>Codex<br>CursorCursor<br>Cline<br>OpenAI Agents SDK<br>VercelVercel AI SDK<br>LangChainLangChain<br>PydanticPydantic AI<br>CAMEL<br>Mastra<br>OpenHands<br>AnthropicClaude Code<br>Codex<br>CursorCursor<br>Cline
Architecture<br>AI agent and application code talks to Mirage's bash and VFS layer. A dispatcher and two-layer cache route reads and writes to the backing infrastructure and remote services.
How does Mirage work?<br>01Declare a workspace<br>In Python or TypeScript, mount the resources your agent needs—an S3 bucket at /s3, a Google Drive folder at /drive, a GitHub repo at /github, RAM at /data, side-by-side under a single root.
02Hand the workspace to your agent<br>Adapters wire the workspace into OpenAI Agents SDK, Vercel AI SDK, LangChain, Pydantic AI, CAMEL, Mastra, or OpenHands. The agent runs against the same mount tree it would in bash.
03Read, write, and pipe across services<br>Agents reuse the bash vocabulary they already know. A two-layer cache keeps repeated work off the network. Workspaces snapshot, clone, and version like a filesystem.
Frequently Asked Questions<br>What is Mirage?<br>Mirage is a virtualization layer for AI agents, mounting data sources, services, and tools as one virtual filesystem with a bash interface. It mounts backends like S3, Google Drive, GitHub, Notion, Redis, and Postgres side-by-side under one root. Agents reach every backend with the same handful of Unix-like tools, and pipelines compose across services as naturally as on a local disk.
Why a filesystem, not yet another SDK or MCP?<br>Modern LLMs are most fluent in bash and the filesystem semantics that come with it. Mirage exposes every backend through the same handful of Unix-like tools, so agents reason about one abstraction instead of N SDKs and M MCPs. Any LLM that already knows bash can use Mirage...