mirage: Unified AI Agent Filesystem
Get a unified virtual filesystem for your AI agents with mirage, a tool for startup founders, backed by 3.3k+ GitHub stars.
3,336 stars242 forksTypeScriptQuality 9/10Updated 7/19/2026100% free ยท open source Mirage provides a unified virtual filesystem for AI agents, allowing them to interact with multiple data sources in a single, cohesive environment.
git clone https://github.com/strukto-ai/mirage.git && cd mirage
- โขWhen building AI agents that need to access and manipulate diverse data sources
- โขWhen requiring a unified interface for AI agents to read and write data across different systems
- โขWhen needing to simplify data management for AI agents with multiple, disparate data sources
- 1Run 'npm install' to set up the project dependencies
- 2Create a new agent configuration file using the example in 'examples/agent.config.ts' as a template
- 3Modify the 'mirage.config.ts' file to specify the data sources and filesystem structure for your AI agent
- 4Start the mirage server with 'npm run start' to make the virtual filesystem available to your AI agent
- 5Use the 'mirage-client' library in your AI agent code to interact with the virtual filesystem
Ready-to-paste prompt npm run start && node examples/agent-example.ts
Heads up: Make sure you have Node.js 16 or later installed, as mirage relies on features only available in this version or newer
Saves to your device
Topics
agent-sandbox
agent-tools
ai-agents
bash
claude-code
fuse
langchain
llm-agents
openai-agents
python
typescript
vfs
virtual-filesystem
What's inside โ free to inspect
No purchase needed
Read the entire source before you build โ unlike paid marketplaces that hide it behind a buy button.