The World's First Virtual Terminal for AI Agents
Agents don't need a sandbox, they need the terminal they were trained on.
npm install @struktoai/mirage-node npm install @struktoai/mirage-browser
const ws = new Workspace({
'/tmp': [new RAMVFS(), MountMode.EXEC],
'/redis': [new RedisVFS({ url: redisUrl }), MountMode.WRITE],
'/slack': [new SlackVFS({ token: slackToken }), MountMode.EXEC],
}, {
runtimes: [buildRuntime('monty', { captures: ['python', 'python3'] }), 'workspace'],
})
// one grep sweeps every source
await ws.shell('grep -rln session /redis /tmp')
// run a script that lives in Slack, report into Redis
await ws.shell('python3 /slack/report.py > /redis/report.txt')
// read the report back with a POSIX-style call
const report = await ws.vfs.read('/redis/report.txt')
// a typed CLI under a head word, found by man and which
ws.registerCli('slack', SLACK, { token: slackToken })
await ws.shell('slack send-message --channel general --text "report is up"')A Real Example
A real Mirage workspace, running in your browser.
mounts: /slack: vfs: slack?Your Slack, read over its API and mounted as folders: one per channel, one per day, the day's messages as chat.jsonl. config: token: search_token: content_search: true?Lets grep -rw ask the service's own search index which files can match, and read only those, instead of every file under the mount. mode: readA real Virtual Terminal, running in browser?Built on the real @struktoai/mirage-browser. Every command runs Mirage in your browser.
A Unified Virtual Filesystem
S3, Google Drive, Slack, Gmail and more mount under one root, read with ls, grep and jq.
Virtual Command Line Tools
git, slack and ntn run inside the workspace, with nothing installed.
The
Shell
Pipes and redirection work across every mount, CLI and script.
$ grep -rl VFS | Virtual CLI | Script
Policy Engine
A script decides whether each command runs, asks first or is refused, and where it runs.
$ grep -rl VFS | Virtual CLI | Script
Profiles and Agents
Each agent runs under a profile that decides what it can see and do.
Portability
runs in your server, in a browser tab, or as a real mountpoint.
$ grep -rl VFS | Virtual CLI | Script
Performance and Efficiency
AgentVFS's benchmark shows agents need far fewer tokens through a virtual filesystem than through MCP.
- Token reduction
- Up to 88%
- Average success rate increase
- +5.5%