mirage
The World's First Unified Virtual Filesystem For AI Agents
Mirage is a Claude Code plugin that implements a unified virtual filesystem, allowing AI agents to access over 50 services and data sources—including S3, Google Drive, Slack, Gmail, Redis, GitHub, and databases—through familiar bash commands. It mounts disparate backends side-by-side under a single filesystem root, enabling agents to read, grep, and pipe data across services without learning service-specific APIs or SDKs. The plugin runs in-process within Python and TypeScript applications, supports portable workspace snapshots, and integrates with major agent frameworks including OpenAI Agents SDK, Vercel AI SDK, LangChain, and Pydantic AI.
Key Features
Use Cases
- 01Search across Slack messages, Redis keys, and S3 objects with a single grep command
- 02Execute Python scripts stored in Slack channels and write results directly to Redis or databases
- 03Copy files between Google Drive, S3, and local storage using standard cp syntax
- 04Build agent pipelines that read from Gmail, filter with bash tools, and write to MongoDB
- 05Create portable agent workspaces that snapshot entire service configurations for version control
- 06Enable coding agents to access cloud storage, databases, and communication platforms through filesystem operations
Related Plugins
View moreandrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
mirage — FAQ
What is the Mirage Claude Code plugin?+
Mirage is a virtual filesystem plugin that mounts cloud services, databases, and communication platforms as a unified filesystem, allowing AI agents to access them using standard bash commands instead of service-specific APIs.
How do I install the Mirage plugin for Claude Code?+
Install Mirage by adding it from the Claude Code plugin marketplace with '/plugin marketplace add strukto-ai/mirage', then activate it with '/plugin install mirage'. For programmatic use, install via 'uv add mirage-ai' for Python or 'npm install @struktoai/mirage-node' for TypeScript.
Which AI clients and frameworks does Mirage work with?+
Mirage supports Claude Code, Codex, DeepSeek Harness, Grok Build, OpenCode, and Pi as coding agents. It also integrates with OpenAI Agents SDK, Vercel AI SDK, LangChain, Pydantic AI, CAMEL, OpenHands, Agno, and Mastra agent frameworks.
Do I need API keys to use Mirage with cloud services?+
Yes, you need credentials for each service you mount—S3 bucket credentials, Slack bot tokens, Gmail OAuth tokens, Redis URLs, etc. Each resource is configured with its respective authentication when you create the workspace.
Is Mirage free to use?+
Mirage is open source under the Apache 2.0 license and free to use. However, you'll incur costs for the underlying services you mount (S3 storage, API calls, etc.) according to those providers' pricing.
What are the system requirements for running Mirage?+
Mirage requires Python ≥3.11 for the Python SDK or Node.js ≥20 for TypeScript. FUSE-based filesystem mounts require macOS or Linux. The plugin runs in-process without requiring a separate daemon or service.
How do I install mirage?+
Open the source repository on GitHub and follow its README. mirage is a plugin — MCP Agents Market links you directly to the official repo.
Is mirage free?+
mirage is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.