정의
S3·Google Drive·Slack·Gmail·Redis·GitHub·Notion 등 이종 백엔드를 단일 Unix 파일시스템 트리로 마운트해 AI 에이전트가 동일한 bash 인터페이스로 모든 서비스에 접근할 수 있게 하는 오픈소스 가상 파일시스템 레이어. (github.com/strukto-ai/mirage, Apache-2.0)
핵심 속성
- 단일 인터페이스 원칙: 에이전트가 서비스별 SDK·MCP 어휘를 새로 익힐 필요 없이, LLM이 이미 학습한 bash 도구(ls, cat, cp, pipe)만으로 모든 마운트 리소스 접근
- 지원 백엔드:
- 스토리지: 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 등 모든 async 런타임에 가상 파일시스템 직접 내장
- 에이전트 프레임워크 호환: OpenAI Agents SDK, Vercel AI SDK, LangChain, Pydantic AI, CAMEL, OpenHands
- 커맨드 확장:
ws.command('summarize', ...)로 신규 커맨드 등록, 특정 리소스·파일타입에 대한 오버라이드 지원 - 2계층 캐시: Index Cache(디렉토리 리스팅·메타데이터) + File Cache(오브젝트 바이트). RAM 또는 Redis 백엔드 선택
관계
- 20260510-agent-hosting-is-where-they-live — 연장: 에이전트 실행 환경에 데이터 접근 레이어를 통합하는 패턴
- 20260515-harness-knowledge-hook-three-pillars — 연결: Knowledge Layer를 파일시스템 추상화로 구현하는 접근법
- 20260522-hermes-agent-data-first-integration — 대조: Hermes가 데이터를 에이전트 메모리로 적재하는 방식 vs Mirage가 데이터를 파일시스템으로 마운트하는 방식
인용
“에이전트가 서비스별 SDK/MCP를 새로 익힐 필요 없이, Unix 계열 bash 도구만으로 모든 백엔드를 다루며, 서비스 간 파이프라인을 로컬 디스크처럼 자연스럽게 구성”
“워크스페이스 자체를 git 처럼 버전 관리 및 클론 가능 … 에이전트한테 mcp/cli 같은거 공부도 하지 말고 걍 파일 처리하듯이 하라고 하는 방식” — 구루 (X, 2026-06-22 재언급)
출처
클리핑 · 재언급 클리핑 · news.hada.io