Workspace as tools, so every file and shell call the agent makes runs in the workspace, not on the host. To run the Antigravity app itself on a workspace, see Antigravity.
Install
mirage-ai[mem0].
Usage
build_config returns a LocalAgentConfig that registers Mirage’s tools, turns off the harness’s own tools and subagents and adds a system prompt describing the mounts. Set GEMINI_API_KEY, then:
build_config(ws, session_id="agent") runs the tools as that session, under its profile. Create the session first with ws.session. system_prompt= replaces Mirage’s prompt, which the harness adds to its own instructions.
Tools
The agent gets the session’s seven tools,session.tools: shell, read, write, edit, ls, grep and glob, only the ones the session’s profile leaves it. A failed call comes back to the model as a tool error.
Of the harness’s own tools only finish stays, so the agent can still return structured output. Subagents are off, since a subagent would get the harness’s file and shell tools back.
Other tools
mirage_tools is the tools alone, to put next to other tools in a LocalAgentConfig: