---
name: Mirage Filesystem
slug: mirage-filesystem
category: DevOps
description: 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.
github: "https://github.com/strukto-ai/mirage/tree/main/plugins/mirage/skills/mirage-filesystem"
language: TypeScript
stars: 3453
forks: 255
install: "npx degit https://github.com/strukto-ai/mirage/tree/main/plugins/mirage/skills/mirage-filesystem ~/.claude/skills/mirage-filesystem"
installs_to: ~/.claude/skills/mirage-filesystem
source_path: plugins/mirage/skills/mirage-filesystem/SKILL.md
collection_size: 1
category_size: 798
added: 2026-08-16T07:02:44.750Z
last_synced: 2026-08-16T07:02:44.750Z
canonical_url: "https://dirskills.com/skills/mirage-filesystem"
---

# Mirage Filesystem

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.

**Install:**

```bash
npx degit https://github.com/strukto-ai/mirage/tree/main/plugins/mirage/skills/mirage-filesystem ~/.claude/skills/mirage-filesystem
```

## 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.
1. Use the Mirage `read` tool before modifying an existing file.
1. Use `edit` for an existing file and `write` only for a new file.
1. 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.
1. 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.