version: "1.0.1" name: mirage-filesystem description: 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.
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
- Use the Mirage
ls, glob, grep, or shell tool to discover mounted data. - Use the Mirage
read tool before modifying an existing file. - Use
edit for an existing file and write only for a new file. - 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.
- Use
shell 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.