# Mirage Filesystem

> 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.

- Skill: `gabrielmoreira/mirage-filesystem` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/mirage-filesystem`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/mirage-filesystem/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/mirage-filesystem

---


# 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.