> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mirage.strukto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> Give an agent a controllable, scriptable and managed Mirage virtual terminal.

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

| Connection | What the agent gets | Reaches the server through |
| - | - | - |
| ![](https://mintcdn.com/struktoai/P2GwmHfVdrabAh4w/images/mcp-icon.svg?fit=max\&auto=format\&n=P2GwmHfVdrabAh4w\&q=85\&s=b63ddad7bf6ff4c9211a88bbae1fe0d1)[MCP](https://docs.mirage.strukto.ai/home/access/mcp.md) | A shell and six file tools through an MCP client. | the HTTP port |
|  [FUSE](https://docs.mirage.strukto.ai/home/setup/fuse.md) | The workspace as a local folder, for the agent's own file tools. | a folder the server mounts |
| ![](https://mintcdn.com/struktoai/yJz6XpKlFIY24Ipv/images/ssh-logo.svg?fit=max\&auto=format\&n=yJz6XpKlFIY24Ipv\&q=85\&s=5b8b0b5b86d3dd4a2d7bd03dbf66a140)[SSH](https://docs.mirage.strukto.ai/home/access/ssh.md) | A remote shell, plus file access through SFTP, SCP or SSHFS. | its own SSH port |
|  [HTTP](https://docs.mirage.strukto.ai/home/access/http.md) or  [RPC](https://docs.mirage.strukto.ai/home/access/rpc.md) | An API for running commands and working with files. | the HTTP port |
|  [CLI](https://docs.mirage.strukto.ai/home/access/cli.md) | `mirage` commands for workspaces and sessions, and `mirage-bash` as a shell. | the HTTP port |

## Supported agents

### Coding agents

Run the agent as it is, on a workspace the `mirage` CLI creates.

| Agent | Shell | MCP | SSH | FUSE |
| - | :-: | :-: | :-: | :-: |
| ![](https://mintcdn.com/struktoai/AvU64XZuiQaceY0a/images/google-logo.svg?fit=max\&auto=format\&n=AvU64XZuiQaceY0a\&q=85\&s=2e310b47ddeda7db24d45a1815a3dc15)[Antigravity](https://docs.mirage.strukto.ai/home/agents/antigravity.md) | | ✓ | ✓ | ✓ |
| ![](https://mintcdn.com/struktoai/F9Lv_nTaj6By6crk/images/claude-logo.svg?fit=max\&auto=format\&n=F9Lv_nTaj6By6crk\&q=85\&s=24f21eb989bc7b3119bbd5d6cc6aa758)[Claude Code](https://docs.mirage.strukto.ai/home/agents/claude-code.md) | ✓ | ✓ | | ✓ |
| ![](https://mintcdn.com/struktoai/F9Lv_nTaj6By6crk/images/openai-logo.svg?fit=max\&auto=format\&n=F9Lv_nTaj6By6crk\&q=85\&s=086e9344aa70f87e32186cd834e92dfb)[Codex](https://docs.mirage.strukto.ai/home/agents/codex.md) | | ✓ | ✓ | ✓ |
|  [Cursor](https://docs.mirage.strukto.ai/home/agents/remote-ssh.md) | | | ✓ | |
| ![](https://mintcdn.com/struktoai/UoY6QG60_Zn_sW0e/images/grok-logo.svg?fit=max\&auto=format\&n=UoY6QG60_Zn_sW0e\&q=85\&s=6b7bae5219e20865c78f2a088d3de87f)[Grok Build](https://docs.mirage.strukto.ai/home/agents/grok-build.md) | | ✓ | | ✓ |
|  [VS Code](https://docs.mirage.strukto.ai/home/agents/remote-ssh.md) | | | ✓ | |

* **Shell**: the agent's own shell is [`mirage-bash`](https://docs.mirage.strukto.ai/home/access/cli#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](https://docs.mirage.strukto.ai/home/setup/machine/overview.md): see [Editors over SSH](https://docs.mirage.strukto.ai/home/agents/remote-ssh.md).
* **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](https://docs.mirage.strukto.ai/home/agents/codex.md#exec-server-forward).

Or load Mirage into the agent as a TypeScript plugin, which replaces its own file and shell tools:

| Agent | Plugin |
| - | - |
| ![](https://mintcdn.com/struktoai/F9Lv_nTaj6By6crk/images/pi-logo.svg?fit=max\&auto=format\&n=F9Lv_nTaj6By6crk\&q=85\&s=9fd1dda1602db8b4e9fd858a396d94bd)[Pi Coding Agent](https://docs.mirage.strukto.ai/typescript/agents/pi.md) | `@struktoai/mirage-pi` |
| ![](https://mintcdn.com/struktoai/F9Lv_nTaj6By6crk/images/pi-logo.svg?fit=max\&auto=format\&n=F9Lv_nTaj6By6crk\&q=85\&s=9fd1dda1602db8b4e9fd858a396d94bd)[Pi Durable](https://docs.mirage.strukto.ai/typescript/agents/pi-durable.md) | `@struktoai/mirage-pi-durable` |
| ![](https://mintcdn.com/struktoai/VnauQRV1qeEFsLrG/images/opencode-logo.svg?fit=max\&auto=format\&n=VnauQRV1qeEFsLrG\&q=85\&s=23868ab566c0ff7c82b7ee0a28154864)[OpenCode](https://docs.mirage.strukto.ai/typescript/agents/opencode.md) | `@struktoai/mirage-opencode` |
| ![](https://mintcdn.com/struktoai/pR5uetkurtm5Peo8/images/deepseek-logo.svg?fit=max\&auto=format\&n=pR5uetkurtm5Peo8\&q=85\&s=4cf1a518a4d03738ae07fbadf07d820e)[DeepSeek Harness](https://docs.mirage.strukto.ai/typescript/agents/dsh.md) | `@struktoai/mirage-dsh` |

### Agent frameworks

| Framework | Python | TypeScript |
| - | - | - |
| ![](https://mintcdn.com/struktoai/F9Lv_nTaj6By6crk/images/claude-logo.svg?fit=max\&auto=format\&n=F9Lv_nTaj6By6crk\&q=85\&s=24f21eb989bc7b3119bbd5d6cc6aa758)Claude Agent SDK | [Guide](https://docs.mirage.strukto.ai/python/agents/claude-agent-sdk.md) | [Guide](https://docs.mirage.strukto.ai/typescript/agents/claude-agent-sdk.md) |
| ![](https://mintcdn.com/struktoai/AvU64XZuiQaceY0a/images/google-logo.svg?fit=max\&auto=format\&n=AvU64XZuiQaceY0a\&q=85\&s=2e310b47ddeda7db24d45a1815a3dc15)Antigravity SDK | [Guide](https://docs.mirage.strukto.ai/python/agents/antigravity.md) | |
| ![](https://mintcdn.com/struktoai/F9Lv_nTaj6By6crk/images/openai-logo.svg?fit=max\&auto=format\&n=F9Lv_nTaj6By6crk\&q=85\&s=086e9344aa70f87e32186cd834e92dfb)OpenAI Agents SDK | [Guide](https://docs.mirage.strukto.ai/python/agents/openai-agents.md) | [Guide](https://docs.mirage.strukto.ai/typescript/agents/openai-agents.md) |
| ![](https://mintcdn.com/struktoai/F9Lv_nTaj6By6crk/images/langchain-logo.svg?fit=max\&auto=format\&n=F9Lv_nTaj6By6crk\&q=85\&s=e80db5bd3f35579605d89e469cfbf598)LangChain Deep Agents | [Guide](https://docs.mirage.strukto.ai/python/agents/langchain.md) | [Guide](https://docs.mirage.strukto.ai/typescript/agents/langchain.md) |
| ![](https://mintcdn.com/struktoai/Yb3z_PER4CcbsPgD/images/agno-logo.svg?fit=max\&auto=format\&n=Yb3z_PER4CcbsPgD\&q=85\&s=473c42c3ad118713a53f907ba09a1bde)Agno | [Guide](https://docs.mirage.strukto.ai/python/agents/agno.md) | |
| ![](https://mintcdn.com/struktoai/OaLqykifYafGIzhl/images/pydantic-logo.svg?fit=max\&auto=format\&n=OaLqykifYafGIzhl\&q=85\&s=0e9cb6e1b9dbb44cb375a75eeffc071a)Pydantic AI | [Guide](https://docs.mirage.strukto.ai/python/agents/pydantic-ai.md) | |
| ![](https://mintcdn.com/struktoai/0jv2NxTbAdMzA18G/images/haystack-logo.svg?fit=max\&auto=format\&n=0jv2NxTbAdMzA18G\&q=85\&s=6bcdbb45f2e9a6e439454a50440b1537)Haystack | [Guide](https://docs.mirage.strukto.ai/python/agents/haystack.md) | |
| ![](https://mintcdn.com/struktoai/knj2_BzAT1UbMQQo/images/vercel-logo.svg?fit=max\&auto=format\&n=knj2_BzAT1UbMQQo\&q=85\&s=d3d0ca4bc2f4543a48ed8b12d0c92816)Vercel AI SDK | | [Guide](https://docs.mirage.strukto.ai/typescript/agents/vercel.md) |
| ![](https://mintcdn.com/struktoai/UoY6QG60_Zn_sW0e/images/mastra-logo.svg?fit=max\&auto=format\&n=UoY6QG60_Zn_sW0e\&q=85\&s=6d13da09cb1a39b6facc5de33a475705)Mastra | | [Guide](https://docs.mirage.strukto.ai/typescript/agents/mastra.md) |

### Hosted agents

| Service | Python | TypeScript |
| - | - | - |
| ![](https://mintcdn.com/struktoai/F9Lv_nTaj6By6crk/images/openai-logo.svg?fit=max\&auto=format\&n=F9Lv_nTaj6By6crk\&q=85\&s=086e9344aa70f87e32186cd834e92dfb)OpenAI Agents API | [Guide](https://docs.mirage.strukto.ai/python/agents/openai-agents-api.md) | [Guide](https://docs.mirage.strukto.ai/typescript/agents/openai-agents-api.md) |
| ![](https://mintcdn.com/struktoai/F9Lv_nTaj6By6crk/images/claude-logo.svg?fit=max\&auto=format\&n=F9Lv_nTaj6By6crk\&q=85\&s=24f21eb989bc7b3119bbd5d6cc6aa758)Claude Managed Agents | [Guide](https://docs.mirage.strukto.ai/python/agents/claude-managed-agents.md) | [Guide](https://docs.mirage.strukto.ai/typescript/agents/claude-managed-agents.md) |

For a custom agent, use the [Python](https://docs.mirage.strukto.ai/python/access/in-app.md) or
[TypeScript](https://docs.mirage.strukto.ai/typescript/access/in-app.md) workspace API. [Session profiles](https://docs.mirage.strukto.ai/home/configuration/session.md)
control what each session can see and do.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.