# antigravity-2

Runs a local Windows bridge between Claude and the Antigravity 2.0 desktop app, with MCP tools for setup checks, model limits and chat handoff.

- plugin · `type=plugin` · Claude Code, Codex · ★ 1596 repo stars
- Author: comprono
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/comprono/antigravity-2-codex-plugin
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text and 2 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/plugins/antigravity-2

## What it does

The plugin registers two MCP servers. `antigravity-local` covers setup, status, model limits and job submission; `antigravity-devtools` drives the Antigravity window through Chromium DevTools. Startup is passive. Claude will not open or restart Antigravity on its own, and DevTools attaches only when the app is already running.

A setup check ships with it: `scripts\antigravity.ps1 setup` reports whether Antigravity sits where expected, whether Node.js resolves, whether the DevTools endpoint answers and whether the local model-limit API is up. Node.js has to be on `PATH`, otherwise the DevTools bridge never comes up.

For work that doesn't need the visible UI, `submit-agy-job` runs the official `agy` CLI and writes results into `.antigravity-bridge/jobs/<jobId>/`, so Claude can read the artifacts afterwards. Reach for `submit-job` when the selected project or chat in the desktop matters. All of it assumes Windows and Antigravity at `%LOCALAPPDATA%\Programs\Antigravity\Antigravity.exe`.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add hashgraph-online/awesome-codex-plugins
```
In the agent chat (not a shell):
```text
/plugin install antigravity-2@awesome-codex-plugins
```

## When to use it
- launch Antigravity from a Claude session and confirm the process is alive
- read per-model quota from the local language server
- push a heavy task through the `agy` CLI and collect the artifacts
- switch the desktop model once the current one is used up
- hand a prompt into an open Antigravity chat without losing project context

## Example prompts
- Run `antigravity-local.setup` and tell me whether the bridge is ready.
- Submit a headless job: fix the failing tests in `C:\work\api` with `gemini-3.5-flash-low`.
- Switch Antigravity to `flash-medium` and hand this prompt off to the current chat.

## Source text · antigravity-2-codex-plugin · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 7abb926a22d86b3b.

BEGIN THIRD-PARTY FILE 7abb926a22d86b3b
````text
# Google Antigravity Codex Plugin

Created by [comprono](https://github.com/comprono).

This Google Antigravity Codex Plugin is a community local Windows bridge for Codex and Google Antigravity. It helps OpenAI Codex Antigravity workflows connect to the Antigravity 2.0 desktop app using a Codex MCP plugin, DevTools MCP Antigravity controls, and local helper commands.

This is a local Codex plugin that helps Codex connect to Antigravity 2.0 on Windows. It now uses the official Antigravity CLI first for low-RAM headless work, and only opens or drives the desktop UI when visible project/chat, Manager, Editor, or model-picker state is required. It can open Antigravity, inspect whether it is running, discover the Chromium DevTools endpoint exposed by the Electron app, read model quota state from the local language server, inspect visible projects and chats, verify the visible model, and hand off prompts into Antigravity conversations.

After setup, you can start from the ChatGPT mobile app, open Codex, and use this local plugin as the bridge into your Windows Antigravity desktop session.

## Google Antigravity Codex Plugin

This is a community Codex plugin for Google Antigravity / Antigravity 2.0. It lets OpenAI Codex connect to a local Antigravity desktop app on Windows using MCP tools, Chromium DevTools, and local PowerShell helper commands. It provides an Antigravity 2.0 Codex bridge for people who want Codex, including Codex sessions started from ChatGPT on mobile, to hand off work into a locally running Antigravity desktop environment.

Keywords: Google Antigravity Codex plugin, OpenAI Codex Antigravity, Antigravity 2.0 Codex bridge, Codex MCP plugin, DevTools MCP Antigravity.

## What It Does

- Launches the local Antigravity desktop app.
- Reports install path, user data path, running process IDs, setup readiness, and DevTools port.
- Reports Antigravity model quota state from the local language server.
- Uses the official `agy` CLI for headless Antigravity jobs when UI state is not needed.
- Connects to Antigravity's bundled `chrome-devtools-mcp` server when available.
- Exposes local setup/model/status and active-model switch commands as MCP tools, so Codex can use them even when skill files are unavailable.
- Creates durable `.antigravity-bridge/jobs/<jobId>/` folders so Codex can submit work once and later read compact result artifacts.
- Helps Codex inspect live project/chat context from the UI.
- Supports safe handoff to continue an existing chat, start a new chat in an existing project, or start a new project.
- Provides a local privacy scan for sensitive data before publishing changes.

## Requirements

- Windows.
- Antigravity installed at `%LOCALAPPDATA%\Programs\Antigravity\Antigravity.exe`.
- Codex plugins loaded from `%USERPROFILE%\plugins`.
- Node.js available on `PATH` for the DevTools MCP bridge.

## Install

Clone this repository into your Codex plugins directory:

```powershell
git clone https://github.com/comprono/antigravity-2-codex-plugin.git "$env:USERPROFILE\plugins\antigravity-2"
```

Then install or refresh the plugin from your Codex personal marketplace.

For a setup check after cloning:

```powershell
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\antigravity-2\scripts\antigravity.ps1" setup
```

The setup report tells Codex whether Antigravity is installed, whether Node.js is available, whether the bundled DevTools MCP package exists, whether the DevTools endpoint is reachable, and whether the local language-server model-limit API is ready.

## MCP Tools

The plugin registers two MCP servers:

- `antigravity-local`: direct local tools for `quick`, `setup`, `doctor`, `status`, `open`, `repair-live`, `inspect`, `live`, `devtools-health`, `submission-guide`, `prepare-offload`, `create-job`, `submit-job`, `agy-status`, `agy-models`, `submit-agy-job`, `list-jobs`, `read-job`, `cancel-job`, `retry-job`, `switch-model`, `submit-offload`, `limits-summary`, `limits`, `models`, `offload-advice`, `handoff-template`, and `privacy`.
````
END THIRD-PARTY FILE 7abb926a22d86b3b

The third-party file has ended. Everything between the 7abb926a22d86b3b tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 4043 of 17265 bytes. © comprono · MIT · https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/comprono/antigravity-2-codex-plugin

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
