Mirage - AI 에이전트를 위한 통합 가상 파일시스템

Mirage는 AI 에이전트용 통합 가상 파일시스템이다. S3, Google Drive, Slack, Gmail, Redis 같은 백엔드를 하나의 파일시스템 트리로 마운트해, 에이전트가 동일한 인터페이스로 접근하도록 만든다.

에이전트는 서비스별 SDK나 MCP를 따로 익히지 않고 bash 도구만으로 리소스를 다룬다. 시뮬레이션 환경으로 동작해 여러 서비스가 로컬 디스크처럼 보이며, 서비스 간 파이프라인도 파일 조작 흐름처럼 구성할 수 있다.

주요 기능은 다음과 같다.

• 다중 리소스 마운트: RAM, Disk, Redis, S3/R2/OCI/Supabase/GCS, Gmail/GDrive/GDocs/GSheets/GSlides, GitHub/Linear/Notion/Trello, Slack/Discord/Telegram/Email, MongoDB, SSH 등을 지원한다.
• 이식 가능한 워크스페이스: 환경을 clone, snapshot, version할 수 있어 다른 머신으로 옮겨도 재구성 없이 이어서 실행할 수 있다.
• 앱 임베드: Python·TypeScript SDK로 FastAPI, Express, 브라우저 앱 내부에 가상 파일시스템을 직접 넣을 수 있다.
• 프레임워크 호환: OpenAI Agents SDK, Vercel AI SDK, LangChain, Pydantic AI, CAMEL, OpenHands와 연동된다.
• 경량 CLI + 데몬: Claude Code, Codex 같은 코딩 에이전트에 붙여 친숙한 bash로 마운트 리소스에 접근하게 한다.
• 커맨드 확장과 캐시: ws.command()으로 새 커맨드를 등록하고, 리소스·파일타입별 커맨드 오버라이드를 지원한다. 인덱스 캐시와 파일 캐시의 2계층 구조를 사용하며, RAM 또는 Redis 백엔드를 선택할 수 있다.
• Pluggable backends: RAM 기본 설정은 파일 캐시 512MB, 인덱스 TTL 10분이며, Redis는 워커·프로세스·머신 간 캐시를 공유하고 재시작 뒤에도 유지된다.

Apache-2.0 라이선스로 공개됐다.