git404hub

what is mirage fr?

strukto-ai/mirage — explained in plain English

Analysis updated 2026-05-18

2,344TypeScriptAudience · developerComplexity · 3/5Setup · moderate

tl;dr

A virtual filesystem for AI agents that makes cloud services like S3, Slack, and GitHub look like ordinary folders so agents can use familiar file commands.

vibe map

mindmap
  root((Mirage))
    What it does
      Virtual filesystem
      Unifies cloud APIs
      Unix-style commands
    Tech stack
      TypeScript
      Python
      LangChain
    Use cases
      Agent file access
      Workspace snapshots
      Cross-service search
    Audience
      Developers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Let an AI agent search Slack messages using `grep` instead of a custom API.

VIBE 2

Give a coding agent unified file-like access to S3, GitHub, and Gmail at once.

VIBE 3

Snapshot and restore an agent's full workspace state.

VIBE 4

Build an agent workflow that copies data between services with `cp`.

what's the stack?

TypeScriptPythonLangChain

how it stacks up fr

strukto-ai/miragemattpocock/ts-error-translatorbutterbase-ai/butterbase
Stars2,3442,4552,196
LanguageTypeScriptTypeScriptTypeScript
Last pushed2024-08-052026-07-03
MaintenanceStaleActive
Setup difficultymoderateeasymoderate
Complexity3/52/54/5
Audiencedeveloperdeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Python 3.12 or higher.

in plain english

Mirage is a virtual filesystem for AI agents, a layer that makes cloud services and data sources look like ordinary folders on a hard drive. Instead of an AI agent needing to know a different API (programming interface) for S3 file storage, Google Drive, Slack, GitHub, Gmail, and each other service, Mirage presents all of them as directories under one unified file tree. The agent can then use familiar Unix-style commands like cp, cat, and grep across all of them as if they were local files. The core idea is that most AI language models already understand shell commands and file paths very well because they were trained on enormous amounts of code and documentation about these concepts. By expressing every external service as a filesystem, Mirage lets AI agents work with a vocabulary they are already fluent in, rather than learning new APIs for each integration. In practice, you define a workspace by mapping paths like /slack, /s3, and /github to the corresponding service connectors. The agent then executes bash commands against that workspace and Mirage handles translating them into the appropriate service calls behind the scenes. Workspaces can be snapshotted, cloned, and versioned, so you can save and restore the full environment state. Mirage ships as Python and TypeScript SDKs and a command-line tool. It integrates with major AI agent frameworks including LangChain, Vercel AI SDK, and OpenAI Agents SDK, and works with coding agents like Claude Code. Python 3.12 or higher is required. The full README is longer than what was provided.

prompts (copy fr)

prompt 1
Set up Mirage to map my Slack and GitHub accounts into a single workspace.
prompt 2
Show me how to snapshot and restore a Mirage workspace.
prompt 3
Use Mirage with LangChain to let my agent grep across Slack and S3.
prompt 4
Explain how Mirage translates a bash `cp` command into an API call.

Frequently asked questions

what is mirage fr?

A virtual filesystem for AI agents that makes cloud services like S3, Slack, and GitHub look like ordinary folders so agents can use familiar file commands.

What language is mirage written in?

Mainly TypeScript. The stack also includes TypeScript, Python, LangChain.

How hard is mirage to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mirage for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.