Skip to main content
Monk supports both Google Antigravity products, which have different installation methods:
  • Antigravity IDE — a VS Code fork. Install the Monk extension from the marketplace, the same way you would in Cursor or VS Code.
  • Antigravity 2.0 — a standalone desktop app and CLI (agy). Install the Monk plugin package into Antigravity’s plugin directory.
Both products share ~/.gemini/config/mcp_config.json for MCP configuration, so monk-agent is accessible from either surface once set up.

​
Antigravity IDE

The Monk VS Code extension works in Antigravity IDE. It installs like any other IDE extension and auto-configures the MCP server.

​
Prerequisites

Make sure you have completed the Monk setup and the MCP server step shows as running in the setup screen.

​
Setup

1

Install the Monk extension

Open Antigravity IDE, go to the Extensions panel, and search for Monk. Or click Install from the marketplace:
antigravity:extension/monk.vscode-monk
2

Allow Monk in the agent panel

Open the agent panel, then go to Settings → Customizations → Manage MCP Servers. Monk should appear for the current project — enable it and approve its tools.
3

Start using Monk

Ask the Antigravity agent to use Monk for deployment, infrastructure, or runtime tasks.Antigravity agent communicating with Monk

​
Antigravity 2.0

Antigravity 2.0 uses a plugin directory instead of a VS Code extension marketplace. The Monk plugin registers the MCP server, injects a monk skill the agent discovers automatically, and starts monk-agent on demand via a pre-invocation hook.

​
Prerequisites

Make sure you have completed the Monk setup so the monk-agent binary is installed at ~/.monk/bin/monk-agent.

​
Setup

1

Download the Monk plugin package

Download and extract the Antigravity plugin bundle from get.monk.io:
curl -fL https://get.monk.io/stable/monk-agent-plugin.zip -o /tmp/monk-agent-plugin.zip
unzip /tmp/monk-agent-plugin.zip -d /tmp/monk-agent-plugin
For the nightly build, replace stable with nightly in the URL.
2

Copy the plugin into Antigravity's plugin directory

cp -r /tmp/monk-agent-plugin/.antigravity-plugin/ ~/.gemini/config/plugins/monk
3

Start monk-agent and register the MCP server

Run the bundled start script once. It launches monk-agent in the background and writes a monk entry to ~/.gemini/config/mcp_config.json:
~/.gemini/config/plugins/monk/scripts/start-monk-agent.sh
4

Open a project in Antigravity 2.0

Plugins load in workspace context — you must have a project open. The monk skill and MCP tools will be available to the Antigravity agent automatically.

Deploy your first app

Monk is connected — now deploy your project

​
Troubleshooting

Monk does not appear in the MCP server list (Antigravity 2.0) Confirm monk-agent is running: 
~/.monk/bin/monk-agent status
If ~/.gemini/config/mcp_config.json is missing a monk entry, re-run the start script: 
~/.gemini/config/plugins/monk/scripts/start-monk-agent.sh
Plugin not visible in Antigravity 2.0 customizations Make sure ~/.gemini/config/plugins/monk/plugin.json exists and that a project is open — Antigravity 2.0 loads plugins in workspace context. Reopen the project or restart the app if the plugin doesn’t appear.

More troubleshooting

Common issues and how to fix them