Skip to main content
ClaudeWave
EN, English
strukto-ai / Subagents

mirage

The World's First Virtual Terminal for AI Agents

  • 3.7k stars
  • 274 forks
  • 40 open issues
  • Language: TypeScript
  • License: Apache-2.0
  • updated

Install

Terminal
git clone https://github.com/strukto-ai/mirage && cp mirage/*.md ~/.claude/agents/
  1. Clone the repository and copy the agent .md definitions into ~/.claude/agents (or .claude/agents inside a project).
  2. Start a new Claude Code session to load the agents.
  3. Delegate work to them with the Task/Agent tool or by name.

Editor's note

Mirage is a virtual filesystem layer that mounts heterogeneous data sources, including S3, Google Drive, Slack, GitHub, Redis, MongoDB, and Postgres, under a single Unix-style directory tree so that AI agents can interact with all of them using familiar bash commands like grep, cat, cp, and wc. Agents and LLMs never need to learn per-service SDKs; instead, they navigate mount points such as /slack/general/ or /s3/report.csv using the same small set of tools across every backend. The library ships as both a Python package (mirage-ai) and TypeScript packages for Node.js and browser runtimes, and integrates with Claude Code via a lightweight CLI and daemon, letting Claude reach every mounted resource through standard shell commands within its existing coding workflow. It also supports the OpenAI Agents SDK, LangChain, Pydantic AI, and Vercel AI SDK. A notable feature is per-resource command overriding: for example, cat on a Parquet file in an S3 mount renders rows as JSON rather than raw bytes. Developers building agent pipelines who want to avoid managing multiple API clients and MCP configurations are the primary audience.

Installable items

1 items in this repository

Work with files and directories mounted in a Mirage virtual filesystem. Use when a task mentions Mirage, mounted cloud or database data, Mirage virtual paths, or asks to inspect, search, create, or edit data exposed through the Mirage tools.

Install
README

Subagents overview

README preview not available. Visit the repo on GitHub for full documentation.
Topics
agent-sandboxagent-toolsai-agentsbashclaude-codedshdsh-pluginfusellm-agentsopenai-agentspythonsshtypescriptvfsvirtual-filesystemvirtual-terminal
Frequently asked

What people ask about mirage

What is strukto-ai/mirage?

strukto-ai/mirage is subagents for the Claude AI ecosystem. The World's First Virtual Terminal for AI Agents It has 3.7k GitHub stars and its last recorded update is dated 2026-10-23.

How do I install mirage?

You can install mirage by cloning the repository (https://github.com/strukto-ai/mirage) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.

Is strukto-ai/mirage safe to use?

Our security agent has analyzed strukto-ai/mirage and assigned a Trust Score of 97/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.

Who maintains strukto-ai/mirage?

strukto-ai/mirage is maintained by strukto-ai. The last recorded GitHub activity is dated 2026-10-23, with 40 open issues.

Are there alternatives to mirage?

Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.

Project homepage
https://www.strukto.ai