LibreAI / Dev Tools / mirage
// devtools · strukto-ai/mirage

mirage

A virtual terminal and filesystem that lets AI agents work across S3, Drive, Slack, Gmail and more.

★ 3.7k stars⑂ 272 forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

mirage is an open-source dev tools project by strukto-ai (strukto-ai/mirage on GitHub). It has 3,681 GitHub stars and 272 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 8 October 2026.

GitHub stars
3,681
Forks
272
License
Apache-2.0
Last updated on GitHub
8 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide the first concrete outcome you want from it, so you can pick the right example, template or mode instead of exploring everything at once.

  2. Get the project

    Clone the repository (or install the published package) and skim its README quick start for the requirements for your platform.

  3. Install and configure

    Run the documented install step and set any required configuration — such as provider keys, data sources or local services — before the first run.

  4. Run your first task

    Execute the smallest documented example end to end, confirm the output is what you expected, then adapt it to your real data or workflow.

// features

Why people love it

Unified virtual filesystem

Many sources mounted side by side under one root, reachable with standard unix tools.

Virtual CLIs

Tools such as git and slack are answered by Mirage itself — nothing to install per service, with separate credentials per virtual tool.

Routed runtimes

Python, JavaScript and other commands run in-process, sandboxed or remotely, decoupled from storage.

Agent profiles

allow / ask / deny govern commands and CLIs; hide / show govern files, so hidden paths are absent, not just unreadable.

Policy engine

A scriptable policy can block dangerous actions before they run, gating every VFS operation and session write.

Live notifications

External changes arrive as an event stream on the mount, so agents react instead of rescanning.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source so you can inspect, configure and run it locally.

    git clone https://github.com/strukto-ai/mirage.git
    cd mirage
  2. Install Mirage

    Install the Python package/CLI or the TypeScript SDK as the README's Installation section describes.

    uv add mirage-ai    # installs the mirage library and the mirage CLI binary
    # or run without installing: uvx mirage-ai
  3. Try the quickstart

    Follow the README quickstart (Python, TypeScript or CLI) to mount a source and run a first command across it.

    mirage  # see README quickstart for the exact first commands
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains mirage?

It is maintained by strukto-ai on GitHub (strukto-ai/mirage), where the source, issues and releases live.

Is it free to use?

Yes — it is free and open source under Apache-2.0, which permits use, modification and commercial redistribution, with licence/notice retention.

Does it need a paid API key?

Mirage itself needs no LLM key; you connect your own service credentials, and your agent brings its own model access.

How does it compare to writing separate SDK integrations or MCP servers per service?

Compared with writing separate SDK integrations or MCP servers per service, mirage's distinguishing focus is: a virtual terminal and filesystem that lets AI agents work across S3, Drive, Slack, Gmail and more. Pick it when that focus matches your need; the alternative may suit you better if its broader or different scope is the priority.

How do I get started?

Clone https://github.com/strukto-ai/mirage (or install its published package), follow the README quick start to install and configure it, then run the smallest documented example — the Run section on this page mirrors those steps.

// keep exploring

Similar tools

Dev Tools

open-terminal

Open Terminal — a computer you can curl: a sandboxed terminal API for AI agents, from Open WebUI.

★ 3.3k starsMIT
View guide →
Dev Tools

agtx

agtx: a terminal Kanban blackboard where Claude, Codex, Grok, and more collaborate on the same tasks.

★ 1.7k starsApache-2.0
View guide →
Dev Tools

OpenCLI

Turn any website into a CLI — and let AI agents drive your already-logged-in browser

★ 29.9k starsApache-2.0
View guide →
Dev Tools

context-mode

Context optimization for coding agents: sandbox tool output, keep sessions lean, remember more

★ 25.7k starsElastic License 2.0
View guide →
Dev Tools

aichat

One Rust CLI for every LLM: shell assistant, chat REPL, RAG, tools and agents across 20+ providers.

★ 10.5k starsApache-2.0
View guide →
Dev Tools

mcp_agent_mail

Gmail for coding agents: identities, inboxes, threads, and file leases over FastMCP, Git, and SQLite.

★ 2.2k starsNOASSERTION
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if mirage is not the right fit.

Get mirage

Free and open — grab the source, star the repo, and start creating.