Overview Mirage gives AI agents a single Unix-style shell over mounted services such as S3, Google Drive, Slack, Gmail and Redis. Commands like grep, ls and jq work across mounts, and each command is routed to an in-process, sandboxed (E2B) or remote runtime. Per-agent profiles allow, ask, deny or hide commands and paths, and a policy script can block actions before they run. Python and TypeScript SDKs exist.
Who it is for: Engineers giving agents governed access to many data sources and CLIs
Strengths One filesystem and shell across S3, Drive, Slack, Gmail and Redis, so pipes work across services Profiles can hide paths entirely, so they are absent from the agent's view Workspace uses about 100 KB and each session about 10 KB, per the README Routes commands between in-process and sandbox runtimes such as Monty and E2B Weaknesses Marked preview status, so APIs may change Each mount needs its own credentials and config in code Libraries like numpy need an external sandbox such as E2B Virtual CLIs listed are only git, slack and ntn What it needs TypeScript Needs E2B (optional sandbox runtime), Credentials for mounted services (S3, Slack, Gmail) Docker env example file Quick answers Is mirage open source? Yes. Its code is on GitHub under the Apache-2.0 license.
Can you run mirage with Docker? Yes. Its repository has a Docker setup: a Dockerfile, a Compose file or a published image.
Also in Agent and MCP starters Rank Project Score 1 deepseek-harness Plugin-based agent harness from DeepSeek with a local Web UI 98 out of 100 score 2 composio TypeScript and Python SDKs that give agents authenticated tools across 1000+ apps 92 out of 100 score 3 conductor Durable workflow engine that orchestrates microservices and LLM agents from JSON 91 out of 100 score # 4mcp-use TypeScript framework for building MCP servers with React Views and an Inspector (opens in a new tab) 87 out of 100 score # 5a2ui Protocol and renderers for agents to stream native UI instead of text (opens in a new tab) 86 out of 100 score
How to choose Choose the framework you want to live with; templates are thin and the framework is the real dependency. Check where state lives (Durable Objects, Postgres, a managed platform) and whether that fits your hosting. Favor templates that ship tests or an eval hook so agent changes can be checked. Health
Releases 8 in the last 12 monthsLast one 8 days ago
Top contributor 73% of commits4,218 of 5,771 in the last 12 months
Security advisories NoneOn GitHub, in the last 12 months
OpenSSF Scorecard Not checked Read from GitHub, deps.dev and OpenSSF on 9 Nov 2026. Bots and coding-agent accounts are left out of the commit counts. Not part of the score: how we check .
License in plain words Apache-2.0 Permissive
Use it at work Yes
Change it and rebrand it Yes
Sell it or host it for others Yes Your part: Keep the notices and mark the files you change. It also grants you the contributors’ patent rights.
A plain summary, not legal advice. Read the license on GitHub ↗ (opens in a new tab)
Set it up Needs before it works: E2B (optional sandbox runtime), Credentials for mounted services (S3, Slack, Gmail).
Bring in an engineer who knows mirage . By the hour for upkeep and fixes, or a fixed price for a build. Our own engineering service; it never changes a rank.
Where to run it Referral links: if you sign up through one, we get a commission. They never change a rank.
Ask your AI assistant The rankings as an MCP server for Claude, Cursor, ChatGPT and any MCP client. Free, no key, read-only.
Setup for other apps → Claude Code claude mcp add archestack -- npx -y @archestack/mcpCopy
Connector URL https://mcp.archestack.com/mcpCopy
Then ask: Compare mirage with its top alternatives on Archestack
Share this rank #6 of 54 in Agent and MCP starters on Archestack, as of 11 Nov 2026.
Show it in your README or on your site The badge below goes in a README; a card with the rank, score and signals goes on a site or blog. Both update twice a day.
Copy for README Copy for your site
Show code README (Markdown)
[](https://archestack.com/best-of-vibe-coding/projects/mirage/)Site or blog (HTML)
<iframe src="https://archestack.com/embed/best-of-vibe-coding/mirage/" title="mirage on Archestack" width="400" height="270" style="border:0;max-width:100%" loading="lazy"></iframe>How badges work Preview the card
Best of Vibe Coding on GitHub Each review comes from the project's README and facts we check on GitHub. The fix form opens with mirage filled in.