VFS.md and SKILL.md

• VFS.md: every mounted path, its layout and which Unix commands work there.
• SKILL.md: the registered CLIs, with each one’s help.

​

Get them

vfs_md = await ws.vfs_md()
skill_md = await ws.skill_md(session_id="agent")
preview = await ws.vfs_md(profile="reader")
await ws.vfs_md("/VFS.md")

const vfsMd = await ws.vfsMd()
const skillMd = await ws.skillMd(undefined, { sessionId: 'agent' })
const preview = await ws.vfsMd(undefined, { profile: 'reader' })
await ws.vfsMd('/VFS.md')

curl http://127.0.0.1:8765/v1/workspaces/demo/vfs-md \
  -H "Authorization: Bearer $MIRAGE_AUTH_TOKEN"

curl http://127.0.0.1:8765/v1/workspaces/demo/sessions/agent/skill-md \
  -H "Authorization: Bearer $MIRAGE_AUTH_TOKEN"

curl -X PUT http://127.0.0.1:8765/v1/workspaces/demo/vfs-md \
  -H "Authorization: Bearer $MIRAGE_AUTH_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"path":"/VFS.md"}'

mirage workspace vfs-md demo
mirage workspace skill-md demo --session agent
mirage workspace vfs-md demo --path /VFS.md

• No session or profile: what the workspace’s default profile allows.
• A session: what that session’s agent sees.
• A profile: a preview of what a session with that profile would see.
• A path: the file appears in the workspace, read-only and always current, so the agent runs cat /VFS.md. Each session reads its own version.

​

What VFS.md says about each path

• Mode: read, write or exec. A path whose VFS cannot change files shows read, whatever mode it is mounted with.
• Layout: how its files are organized and what they hold, for a VFS that has one. A VFS sets it with vfs_md.
• Supported commands: the Unix commands that work there, which of them use the service’s own search, and the path’s own commands, such as chroma-query on Chroma.
• Limitations: where it differs from a local filesystem, such as being read only, or the walk_limit on large folders.