정의
Mirage는 S3, Gmail, Slack, Redis 등 다양한 백엔드를 단일 파일시스템 트리로 마운트하여 AI 에이전트가 Unix bash 도구만으로 모든 리소스에 접근할 수 있게 하는 오픈소스 가상 파일시스템이다. LLM이 이미 학습한 bash 인터페이스를 그대로 활용함으로써 별도의 SDK나 MCP 학습 없이도 에이전트가 다양한 서비스를 조작할 수 있게 설계되었다.
핵심 속성
- 다중 리소스 마운트: RAM, Disk, Redis, S3, Gmail, GitHub, Slack 등 20여 가지 백엔드를 단일 루트 아래에 배치
- 단일 인터페이스: 모든 백엔드에 대해
ls,cat,cp,find등 표준 Unix 명령어 사용 가능 - 명령 확장(Command Extension):
ws.command()로 새로운 명령을 등록하고, 특정 리소스·파일타입에 대해 오버라이드 가능 - 2계층 캐시: Index Cache(메타데이터)와 File Cache(객체 바이트)로 성능 최적화
- 플러거블 백엔드: RAM(기본, 512MB 캐시) 또는 Redis(분산 공유, 재시작 유지) 선택 가능
- 워크스페이스 이식성: 환경을 clone, snapshot, versioning 가능, 다른 머신으로 이동 시 재구성 불필요
- 앱 임베드: Python/TypeScript SDK로 FastAPI 등 async 런타임 내부에 가상 FS 부여 가능
관계
- plan9-distributed-operating-system — 유사한 철학: 네트워크 리소스를 로컬 파일시스템처럼 접근 (상위개념/영감)
- agent-computer-interface-standard — 대조: MCP 같은 별도 프로토콜 대신 기존 Unix 인터페이스 재사용 (연장)
- agentdir-agent-readonly-filesystem — 유사 도구: AgentDir은 read-only 가상 FS, Mirage는 양방향 (대조)
- ai-agent-frameworks — 호환 대상: OpenAI Agents SDK, LangChain, Vercel AI SDK 등 (연장)
인용
“에이전트가 서비스별 SDK/MCP를 새로 익힐 필요 없이, Unix 계열 bash 도구만으로 모든 백엔드를 다루며, 서비스 간 파이프라인을 로컬 디스크처럼 자연스럽게 구성” “bash를 이미 학습한 LLM이라면 별도 어휘 학습 없이 바로 사용 가능”