- Mirage là open-source VFS cho phép AI agent dùng cat, grep, head và pipe trên S3, Google Drive, Slack, GitHub, Notion, MongoDB và hơn 15 service khác như thể chúng là file local.
- Được xây trong 6 tuần với 1.1M+ dòng code, Apache 2.0.
- Hỗ trợ OpenAI Agents SDK, Vercel AI SDK, LangChain, Mastra.
- v0.0.1 ra mắt ngày 6/5/2026.
TL;DR
Strukto.ai vừa ra mắt Mirage - một unified virtual filesystem (VFS) open-source cho phép AI agents dùng cat, grep, head, wc và Unix pipes trên hơn 15 service khác nhau (S3, Google Drive, Slack, GitHub, Notion, MongoDB, SSH...) như thể chúng đều là file trên ổ cứng local. Không cần học SDK riêng cho từng service. Không cần cấu hình MCP phức tạp. Agent đã biết bash là dùng được ngay.
Dự án xây trong 6 tuần, 1.1M+ dòng code, license Apache 2.0. v0.0.1 ra mắt ngày 6/5/2026.
Vấn đề mà agent đang gặp
Một production AI agent thường cần chạm tới nhiều service cùng lúc: kéo log từ S3, đọc ticket từ Linear, check comment trên GitHub, tổng hợp tài liệu từ Notion. Mỗi service lại có SDK riêng, auth riêng, data model riêng.
Kết quả là agent phải học từng API một, orchestration code phình to, và mỗi lần thêm service mới lại phải refactor toàn bộ integration layer. Với LLM-based agents vốn đã fluent với bash, đây là overhead không cần thiết.
Mirage giải quyết bằng cách mount tất cả service đó vào một cây filesystem Unix duy nhất.
Mirage hoạt động thế nào
Kiến trúc của Mirage gồm ba lớp:
VFS Layer: Expose mọi service dưới dạng đường dẫn file. Ví dụ
/s3/bucket-name/,/slack/general/,/github/org/repo/issues/.Dispatcher & Cache: Nhận command từ agent, route tới đúng backend, cache kết quả. Index cache TTL 10 phút, file cache mặc định 512 MB RAM (tùy chọn Redis cho multi-machine).
Backends: Adapter cho từng service - S3/R2/OCI/Supabase/GCS, Gmail/Drive/Docs/Sheets/Slides, GitHub/Linear/Notion/Trello, Slack/Discord/Telegram, MongoDB, Redis, SSH.
Đặc biệt, Mirage override các command quen thuộc để hiểu format dữ liệu: cat trên file .parquet render rows dạng JSON thay vì raw bytes. wc -l trên .csv đếm số dòng record. Agent không cần biết gì thêm.
Bash trên mọi thứ - Những gì bạn làm được ngay
Một số ví dụ thực tế từ docs:
Đọc analytics từ S3 không cần AWS SDK:
cat /s3/events/2026-05-06.parquet | jq .userĐếm alert trong Slack channel:
grep alert /slack/general/*.json | wc -lStitch S3 + Drive + GitHub + Slack + Linear vào một pipe duy nhất với Unix semantics xuyên suốt.
Snapshot toàn bộ workspace (tất cả mounts, cache state) với một API call:
ws.snapshot("demo.tar")Restore trên máy khác:
mirage workspace load demo.tar --id demo-restored
Workspace versioning cho phép agent loop thử nghiệm mà không sợ mất state. Clone, rollback - tất cả qua một lệnh.
Kỹ thuật đằng sau
Thông số | Giá trị |
|---|---|
Dòng code | 1.1M+ (6 tuần) |
Index cache TTL | 10 phút |
File cache default | 512 MB RAM |
File cache distributed | Redis (tùy chọn) |
Python yêu cầu | >= 3.12 |
Node.js yêu cầu | >= 20 |
License | Apache 2.0 |
Platform | macOS, Linux (FUSE) |
Framework adapters có sẵn tại launch: OpenAI Agents SDK (MirageSandboxClient), Vercel AI SDK (mirageTools()), LangChain, Pydantic AI, CAMEL, OpenHands, Mastra. Có thể embed vào FastAPI, Express hoặc browser app.
So với Mesa, AgentFS và Box VFS
Mirage không cô đơn trong cuộc đua agent filesystem, nhưng định vị khác biệt rõ ràng:
Mesa: Tập trung vào versioned POSIX-compatible storage cho output của agent. Không unify external live services. Không có format-aware commands.
AgentFS (Turso): SQLite-backed local state persistence, SQL-queryable audit log. Rất tốt cho agent observability nhưng không mount S3 hay Slack.
Box VFS: Enterprise-grade với RBAC, audit log, governance. Nhưng giới hạn trong Box ecosystem, không open-source, không LLM-native.
Điểm Mirage dẫn đầu: unify heterogeneous live external services (không chỉ local storage), format-aware bash commands, và zero new vocabulary cho LLM. Agent đã biết bash là plug-and-play ngay.
Cài đặt, giá và ai nên dùng ngay
Cài đặt:
Python:
uv add mirage-ai(yêu cầu Python >= 3.12)TypeScript/Node:
npm install @struktoai/mirage-node(Node >= 20)Browser/Edge:
@struktoai/mirage-browserRuntime-agnostic core:
@struktoai/mirage-core
Giá: Hoàn toàn miễn phí, self-hosted, Apache 2.0. Không có paid tier tại launch.
Ai nên thử ngay:
Developers xây production agent cần touch nhiều cloud service - loại bỏ SDK sprawl.
LLM-based coding agents như Claude Code, Codex, OpenHands - đã biết bash, dùng được ngay.
Data teams deploy agent trên analytics data (S3/GCS) kết hợp collaboration data (Slack/Linear).
Indie devs muốn wire agent vào nhiều service mà không manage hàng chục integration riêng lẻ.
Lưu ý: v0.0.1 rất early - expect breaking changes, docs chưa đầy đủ, Windows chưa support (FUSE dependency). Không có performance benchmark công khai về latency overhead của VFS layer so với direct SDK calls.
Tiếp theo là gì
Chưa có public roadmap, nhưng từ tweet của founder và codebase: team đang hướng tới deeper integration với Claude Code và Codex, thêm mount types, và mở rộng bash command compatibility. Companion product AgentBox (free in-browser AI Agent OS) đã live song song.
Nếu bạn đang xây agent cần đụng tới nhiều service, đây là abstraction đáng bookmark ngay - dù còn rất sớm.
