Skip to main content

Access

Every connection goes to one Mirage server, so they all see the same workspaces and sessions. Most use its HTTP port, 8765 by default.

Supported agents

Coding agents

Run the agent as it is, on a workspace the mirage CLI creates.
  • Shell: the agent’s own shell is mirage-bash, so every command it runs goes to the workspace.
  • MCP: the agent gets Mirage’s seven tools beside its own, from its plugin or mirage mcp.
  • SSH: the agent’s own tools run in the workspace. Cursor, VS Code and Antigravity run their server on a machine: see Editors over SSH.
  • FUSE: the agent’s own tools work on the workspace, mounted as a folder.
Codex can also run in the workspace from a remote harness, through exec-server forward. Or load Mirage into the agent as a TypeScript plugin, which replaces its own file and shell tools:

Agent frameworks

Hosted agents

For a custom agent, use the Python or TypeScript workspace API. Session profiles control what each session can see and do.