Skip to content
Development
Skill

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

BOOST
@strukto-aistrukto-ai@strukto-ai
From plugin
mirage
3.8k2 skills1 MCP

Claude Code

$ npx -y skills add strukto-ai/mirage --skill mirage-filesystem --agent claude-code

SKILL.md

mirage-filesystem.SKILL.md
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

1. Use the Mirage `ls`, `glob`, `grep`, or `shell` 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 `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.

Read it on GitHub ↗
Stats
PythonTypeScriptNodePostgreSQLMongoDBRedisAWSCloudflareGitHubHugging FaceSlackNotion
3,782
Stars
284
Forks
Active
Maintenance
TypeScript
Language
Apache-2.0
License
Last commit
Created

Repo: strukto-ai/mirage

In this plugin
2 skills1 MCP
See everything inside
@strukto-ai
Ships withmirage

The World's First Virtual Terminal for AI Agents

3.8k2 skills1 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
3.8k
Star history of strukto-ai/mirage on GitHub, a chart by star-history.com
See what's trending this week

Other skills on mirage.

mirage-vfs-authoring

mirage-vfs-authoring

Build or extend a custom Mirage VFS adapter for a user's API, database, object store, or application data. Use when connecting a…

mirage
@strukto-ai@strukto-aiInstall Skill

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

superpowers12d311k
@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills11d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc12d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react1d252k
@facebook@facebookInstall Skill

Questions about mirage-filesystem.

Which coding agents can use mirage-filesystem?
mirage-filesystem installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.