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

mirage

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.

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

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

  • Let an agent grep across Slack, Drive and S3 in one command
  • Give an agent a sandboxed terminal without installing per-service SDKs
  • Run a script stored in Slack and file its report into Redis
  • Enforce allow/deny policies on what an agent can touch
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.

  • OpenCode★ 211.6k

    The open source coding agent

  • Transformers★ 166.9k

    The model-definition framework behind modern AI — thousands of pretrained transformers for text, vision, and audio.

  • claude-code★ 149.7k

    Anthropic's agentic coding tool that lives in your terminal and works across your whole codebase

  • cc-switch★ 141.3k

    Cross-platform desktop all-in-one manager for Claude Code, Codex, OpenCode and other coding agents

  • codex★ 128.2k

    OpenAI's lightweight coding agent that runs locally in your terminal

// more in devtools

More in Dev Tools

Nearby Dev Tools projects in the catalogue, closest in stars to mirage — keep exploring the shelf either side of it.

  • abtop★ 3.7k

    Like htop, but for AI coding agents — watch Claude Code and Codex sessions in real time.

  • twinny★ 3.7k

    Open-source AI coding assistant for VS Code. Code completion, chat, edits and reviews with local or hosted models. Your models, your infrastructure.

  • java-sdk★ 3.7k

    The official Java SDK for building Model Context Protocol servers and clients.

  • evalscope★ 3.5k

    A streamlined framework for evaluating and benchmarking LLMs, VLMs and AIGC models.

  • lazycodex★ 3.7k

    The agent harness for complex codebases inside Codex — project memory, planning and verified completion.

  • AnyCrawl★ 3.5k

    A Node.js crawler that turns websites into LLM-ready data and extracts structured SERP results.

Get mirage

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