🗂️
DevOpsTypeScript

Mirage Filesystem

by strukto-ai

Mirage Filesystem is a DevOps skill for Claude Code, published by strukto-ai in mirage.

3.5K stars255 forkson strukto-ai/mirageAdded 2026/08/16+1% in starsRepository updated 2026/08/16
agent-sandboxagent-toolsai-agentsbashclaude-codedshdsh-pluginfusellm-agentsopenai-agentspythontypescriptvfsvirtual-filesystem
Install in seconds
Install Mirage Filesystem
Copy Mirage Filesystem into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/strukto-ai/mirage/tree/main/plugins/mirage/skills/mirage-filesystem ~/.claude/skills/mirage-filesystem

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/strukto-ai/mirage.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
plugins/mirage/skills/mirage-filesystem/SKILL.md in strukto-ai/mirage
Installs to
~/.claude/skills/mirage-filesystem
Collection
The only skill cataloged from this repository
Category
DevOps798 skills

What Mirage Filesystem does

Mirage Filesystem works with files and directories mounted in a Mirage virtual filesystem, using Mirage tools for virtual paths that host filesystem tools cannot access. Use it when a task mentions Mirage, mounted cloud or database data, virtual paths, or asks to inspect, search, create, or edit data exposed through the Mirage tools.

Mirage Filesystem is cataloged under DevOps on DirSkills. Mirage Filesystem comes from a repository tagged agent-sandbox, agent-tools, ai-agents, bash and claude-code.

Documentation

README

Mirage Filesystem

Use the Mirage tools for virtual paths. Host filesystem tools cannot access those paths unless the user separately configured a FUSE mount.

Workflow

  1. Use the Mirage ls, grep, or execute_command tool to discover mounted data.
  2. Use the Mirage read tool before modifying an existing file.
  3. Use edit for an existing file and write only for a new file.
  4. If an edit reports that the file changed since it was read, read the file again, reconsider the edit against the new content, and retry.
  5. Use execute_command for pipelines and structured-file commands that need Mirage shell semantics.

Do not fall back to a host filesystem tool when a Mirage tool fails on a virtual path. Report the Mirage error or fix the Mirage configuration.

Frequently asked about Mirage Filesystem

  • How does Mirage Filesystem compare to other DevOps skills?

    Mirage Filesystem ranks #198 by stars among the 798 DevOps skills in this catalog. The most-starred ones next to it are Backend Patterns, API Connector Builder and Migration. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Mirage Filesystem against them. Open each page to compare what they document and how they install.