К основному содержанию
плагин CX Codex

antigravity-2 — плагин для Claude Code: мост к Antigravity 2.0

Связывает Codex с десктопным Antigravity 2.0 на Windows: проверка установки, лимиты моделей, headless-задачи через CLI и передача промптов в чат.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install antigravity-2@awesome-codex-plugins
Открыть на GitHub

Что делает antigravity-2

Плагин поднимает локальный мост между Codex и Antigravity 2.0 на Windows. Внутри два MCP-сервера: antigravity-local с инструментами вроде quick, setup, status, submit-agy-job, switch-model, limits-summary и antigravity-devtools для управления окном приложения через Chromium DevTools. Запуск пассивный: открытие Codex не открывает и не перезапускает Antigravity, а DevTools подключается только к уже работающему приложению.

Проверка после клонирования — scripts\antigravity.ps1 setup. Отчёт скажет, установлен ли Antigravity, виден ли Node.js, отвечает ли порт DevTools и готов ли локальный API лимитов моделей. Без Node.js в PATH DevTools-мост не заработает.

Работу без видимого интерфейса отдавайте через submit-agy-job: он вызывает официальный CLI agy и складывает результаты в .antigravity-bridge/jobs/<jobId>/, чтобы Codex потом прочитал артефакты. submit-job нужен, когда важен конкретный открытый проект или чат. Всё это живёт на Windows и ждёт Antigravity по пути %LOCALAPPDATA%\Programs\Antigravity\Antigravity.exe.

Какие задачи решает

  • запустить Antigravity из сессии Codex и убедиться, что процесс жив
  • прочитать остаток квоты по каждой модели из локального language server
  • прогнать тяжёлую задачу headless через CLI agy и забрать артефакты
  • переключить модель на flash-medium, когда текущая кончилась
  • передать промпт в открытый чат Antigravity, сохранив контекст проекта

Примеры запросов агенту

  • Проверь через antigravity-local.setup, готов ли мост к Antigravity, и покажи отчёт.
  • Отправь задачу через submit-agy-job: починить тесты в C:\work\api, модель gemini-3.5-flash-low.
  • Переключи Antigravity на flash-medium и передай этот промпт в текущий чат.

Как установить antigravity-2

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install antigravity-2@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы об antigravity-2

Как установить antigravity-2 в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем выполните /plugin install antigravity-2@awesome-codex-plugins.

Что делает antigravity-2?

Соединяет Claude с приложением Antigravity 2.0 на Windows через два MCP-сервера: проверяет готовность установки, читает лимиты моделей и передаёт работу в проекты и чаты Antigravity.

Что нужно, чтобы плагин заработал?

Windows, Antigravity по пути %LOCALAPPDATA%\Programs\Antigravity\Antigravity.exe, плагины Claude из %USERPROFILE%\plugins и Node.js в PATH для DevTools-моста.

Исходный текст

antigravity-2-codex-plugin · MIT
# 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`.
- `antigravity-devtools`: Chromium DevTools controls for inspecting and driving the Antigravity UI.

Startup is passive. Opening Codex must not open, close, restart, or repair Antigravity. The DevTools MCP server only connects when Antigravity is already running and inspectable; use `antigravity-local.open` or `antigravity-local.repair-live` only after the user asks to use Antigravity.

Codex should call `antigravity-local.submit-agy-job` first for nontrivial workspace work that does not require visible desktop project/chat state. It uses official Antigravity CLI print mode, creates the same durable job folder, and avoids desktop RAM overhead. Use `antigravity-local.submit-job` only when the correct visible Antigravity project/chat is already selected and that UI context matters. Use `antigravity-local.submit-offload` only for lightweight selected-chat handoffs that do not need a durable job folder. If Sonnet/Opus/GPT-OSS is exhausted or the user asks for Flash in desktop UI, Codex should call `antigravity-local.switch-model` with `modelPreference=flash-medium` before submitting. If the MCP tool list is stale and does not show the job/model tools, use the PowerShell helper `antigravity.ps1 submit-agy-job` / `antigravity.ps1 submit-job` / `antigravity.ps1 switch-model` before falling back to DevTools choreography. Use `antigravity-local.prepare-offload` when Codex should show the plan first or when the selected chat is uncertain. For nontrivial workspace, repo, browser, UI, research, planning, debugging, review, implementation, and job-application work, the intended cost split is: Antigravity explores and works locally; Codex plans, gates safety, reviews final changes, and summarizes from job artifacts. Use `antigravity-local.quick` for general setup checks. If `ReadyForLiveUiInspection` is false, call `antigravity-local.repair-live` once before using DevTools. If repair restarts Antigravity, an already-started DevTools MCP connection may need to reconnect to the new port. If `antigravity-devtools` fails with `Transport closed`, call `antigravity-local.devtools-health`; do not keep retrying `list_pages` in the same broken transport. Use `limits-summary` for normal quota checks and full `limits` only when the complete per-model JSON is needed.

Headless CLI check:

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

Headless CLI job:

```powershell
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\antigravity-2\scripts\antigravity.ps1" submit-agy-job -Goal "<goal>" -Workspace "<path>" -Mode fast -NextStep "<next step>" -AgyModel gemini-3.5-flash-low
```

Existing-chat submissions are strict. If `expectedChat` is provided, it must match the active Antigravity document title, not merely a sidebar item or previous message. The helper refuses to submit in a new chat and records `submit_failed` when Antigravity does not accept the prompt. Codex must not wait for artifacts unless the helper returns `Submitted: true`.

For the lowest-token phone workflow, prefer `antigravity-local.submit-job` over raw chat watching. It creates:

```text
.antigravity-bridge/
  jobs/
    <jobId>/
      request.md
      status.json
      result.md
      changed-files.txt
      diff.patch
      test-output-summary.md
```

Codex should submit the job, stop watching the UI, and later call `read-job` to read only `result.md`, `changed-files.txt`, `diff.patch`, `test-output-summary.md`, and `status.json`.

## Usage

Check status:

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

Fast combined readiness and quota summary:

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

Open Antigravity:

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

Repair live DevTools inspection if Antigravity is running but exposes zero pages:

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

Inspect integration details:

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

Inspect live UI connection:

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

After a DevTools MCP `Transport closed` error, use the local fallback:

```text
Call antigravity-local.devtools-health.
```

If it reports pages are ready, restart Codex to recreate the DevTools MCP transport or use `antigravity-local.handoff-template` for a manual paste into Antigravity for the current turn.

Report model quota state:

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

The `limits-summary` command gives a compact availability summary. The `models` and `limits` commands call Antigravity's local language server over its gRPC-web API (`LanguageServerService/GetAvailableModels` and `GetLoadCodeAssist`) and return the fuller per-model data. This is the same source the Antigravity Models tab uses. It returns per-model quota metadata such as remaining fraction and reset time when available. It does not expose a raw all-model token ledger if Antigravity itself does not publish one.

Switch the current Antigravity chat to a cost-saving available model:

```powershell
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\antigravity-2\scripts\antigravity.ps1" switch-model -ModelPreference flash-medium -ExpectedProject "<visible project>" -ExpectedChat "<visible chat>"
```

`switch-model` uses the local model-limit summary to choose an available model, then uses the local CDP bridge to select it in the visible Antigravity chat. `flash-medium` prefers `Gemini 3.5 Flash (Medium)` when available, then falls back to another available Flash/Gemini model.

Run a local repository privacy scan:

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

## Codex Operating Model

This plugin intentionally combines two local surfaces:

- Stable status and model-limit checks use local helper commands and Antigravity's local language server.
- Project/chat actions use the live Antigravity UI through the `antigravity-devtools` MCP bridge, because the UI is the source of truth for selected projects, selected conversations, composer state, and model selection.

For chat actions, Codex should verify the target project, conversation, and selected model before sending anything. For new projects or new chats, Codex should use the visible Antigravity controls through DevTools automation and report whether Antigravity accepted the action or showed an error/quota state.

For nontrivial work, Codex should act as the orchestrator, not the main worker. Codex gives Antigravity compact tasks, waits, reads only status artifacts or targeted diffs, reviews the result, and sends the next improvement task back to Antigravity. Codex should avoid duplicating Antigravity's broad file reading, browser operation, and long reasoning unless Antigravity is blocked or final verification requires it.

For prompt submission, Codex should call `antigravity-local.submission-guide` or follow the same rule: fill/type the prompt without a `submitKey`, then click the visible Send/arrow button. If a keyboard submit is required, use a separate key call with a simple accepted key such as `Enter`. Do not use `Control+Enter`, `Ctrl+Enter`, or chord strings unless the active tool schema explicitly lists that exact value; some DevTools tools reject those strings with `Unknown key`.

## Token-Saving Offload Pattern

Use this plugin to make Codex the router and verifier while Antigravity does the long work. Codex should avoid reading huge files, full logs, or full Antigravity chat transcripts. Instead, Codex sends Antigravity a compact handoff, lets Antigravity inspect the workspace locally, and reads back only a small artifact or status checkpoint.

Token savings are not automatic. First decide whether the task is worth offloading:

- Keep Codex direct only for arithmetic, short factual answers, tiny shell checks, small summaries, and prompts that do not need workspace context.
- Use Antigravity by default for project work, implementation, debugging, reviews, planning, research, UI operation, job-search/application workflows, and analysis where Antigravity can inspect local files and write a compact result.
- In existing project chats, assume Antigravity may inspect attached folders before answering. That is useful for real project work and wasteful for tiny tests.
- If Antigravity starts broad folder exploration for a small task, cancel it and answer directly in Codex.

Recommended flow:

1. If the task does not need visible desktop UI state, run `antigravity-local.submit-agy-job` first.
2. If the correct Antigravity project/chat is already selected and visible UI context matters, run `antigravity-local.submit-job` with `submit=true`, plus `expectedProject` and `expectedChat` when known.
3. If the selected chat is uncertain, run `antigravity-local.prepare-offload`, then use DevTools only to select the project/chat; use `switch-model` for model changes.
4. If it returns `codex-direct`, do not open or drive Antigravity.
5. Ask Antigravity to write progress to `.antigravity-bridge/jobs/<jobId>/status.json` and the required result/diff/test artifacts.
6. Codex reads only `read-job`, a targeted diff, or a compact visible UI status.
7. If the result is incomplete, Codex sends a short follow-up task or `retry-job` back to Antigravity with the exact gap instead of pulling broad context into Codex.
8. Codex summarizes for the user after Antigravity has produced a useful result or is clearly blocked.

If a Codex session cannot see MCP tools and can only run shell commands, use the equivalent PowerShell helper:

```powershell
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\antigravity-2\scripts\antigravity.ps1" submit-agy-job -Goal "<goal>" -Workspace "<path>" -Mode fast -NextStep "<next step>" -AgyModel gemini-3.5-flash-low
```

For selected-chat direct submission through the PowerShell helper:

```powershell
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\antigravity-2\scripts\antigravity.ps1" submit-offload -Goal "<goal>" -Workspace "<path>" -StatusFile "notes/antigravity-status.md" -NextStep "<next step>" -ExpectedProject "<project text>" -ExpectedChat "<chat text>" -ModelPreference auto -Submit true
```

Use `-Submit false` for verify-only; it should not fill the composer. Use `-FillOnly true` only when the user wants to manually review the handoff before sending.

For durable job submission through the PowerShell helper:

```powershell
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\antigravity-2\scripts\antigravity.ps1" submit-job -Goal "<goal>" -Workspace "<path>" -Mode fast -NextStep "<next step>" -ExpectedProject "<project text>" -ExpectedChat "<chat text>" -ModelPreference auto
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\antigravity-2\scripts\antigravity.ps1" list-jobs -Workspace "<path>"
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\antigravity-2\scripts\antigravity.ps1" read-job -Workspace "<path>" -JobId latest
```

Modes are `fast`, `deep`, `review`, and `patch`. Use `create-job` when you want to create the folder without touching Antigravity, `retry-job` to resubmit an existing request, and `cancel-job` to mark the bridge job cancelled.

If UI submission is blocked by a stale DevTools port, use `antigravity-local.handoff-template` to generate the compact prompt and avoid repeated CDP probing. Restart Codex or paste the generated handoff manually so the next session attaches to the current Antigravity port.

Compact handoff template:

```text
Goal: <goal>
Workspace: <path>
Constraints: inspect files locally; do not paste full files, full logs, or full source; use search before reading whole files.
Token rule: work token-efficiently; write progress to <small-status-file>; output max 10 bullets plus changed file list.
Next step: <specific next action>
If blocked: ask one concise question; otherwise continue autonomously.
```

## Safety

This plugin operates only on the local machine and local Antigravity profile. It does not patch Antigravity internals, commit runtime tokens, or call Antigravity cloud APIs directly. Treat Antigravity user data, settings, chats, and workspace files as user-owned state.

Before publishing changes, run:

```powershell
powershell -ExecutionPolicy Bypass -File ".\scripts\antigravity.ps1" privacy
```

## License

MIT

© comprono · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
Async Parallel Antigravity for Codex & Claude Code varadfromeast Async Parallel Antigravity for Codex & Claude Code — MCP-сервер для Codex и Claude Code, который запускает параллельные сессии Antigravity CLI с возможностью ставить их на паузу, возобновлять и подключать к терминалу. CX Codex +1 ★ 17звёзд репо agy-delegate amElnagdy Скилл agy-delegate для Claude Code и других агентов, который передаёт задачу на реализацию в Google Antigravity CLI (agy), а вы остаётесь ревьюером. Сами пишете бриф, проверяете diff и коммитите. CX Codex +1 6 500установок antigravity-workflows sickn33 Скилл antigravity-workflows для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который превращает сложную цель в последовательность вызовов специализированных скиллов. CX Codex +1 923установок second-opinion trailofbits Скилл second-opinion запускает независимое внешнее код-ревью через CLI Codex или Antigravity. Помогает проверить незакоммиченные правки, диффы веток и отдельные коммиты. CX Codex +1 5 900установок oh-story zenstory-ai Управляет написанием веб-новелл через скиллы oh-story. Маршрутизирует задачи между сценариями, фиксирует память автора и защищает структуру глав. CX Codex +1 ★ 8 821звёзд репо gemini-agents Paweł Huryn Скилл gemini-agents для Claude Code подключает Antigravity CLI как партнёра для сборки и ревью кода. Перед каждым запуском агент сообщает способ входа и позицию Google, затем получает согласие. CX Codex +1 ★ 741звёзд репо

Из того же набора391

Весь набор →
axonflow Плагин axonflow для Claude Code проверяет команды и действия Codex по политикам, ищет PII и секреты, записывает аудит. Блокировки получают decision_id. CX Codex ★ 1 596звёзд репо autocad-tianzheng-tools Плагин autocad-tianzheng-tools подключает Codex к AutoCAD и Tianzheng HVAC через локальный MCP-сервер, чтобы агент смотрел DWG-чертежи и выполнял операции в них. CX Codex ★ 1 596звёзд репо arcmira Плагин arcmira для Claude Code и Codex ищет в расшифровках YouTube-видео и подкастов цитаты с таймкодами, спикеров и спонсоров. Анализирует упоминания компаний и готовит к интервью. CX Codex ★ 1 596звёзд репо apple-calendar Плагин apple-calendar для Claude Code и Codex связывает их с локальными macOS Calendar и Reminders: показывает расписание, создаёт события и управляет напоминаниями. CX Codex ★ 1 596звёзд репо anime-reaction-gif Плагин anime-reaction-gif для Claude Code и Codex генерирует анимационные реакции в формате GIF и MP4 из набора ключевых поз. Собирает姿势图 через встроенный image_gen, нарезает кадры и склеивает цикл через FFmpeg. CX Codex ★ 1 596звёзд репо aient Подключает MCP-сервер Aient для просмотра телеметрии, разбора проблем и устранения их причин. Анализирует события в рабочей среде. CX Codex ★ 1 596звёзд репо aident-loadout Удалённый MCP-сервер aident-loadout, который открывает агенту доступ к вашим приложениям и 400+ скиллам через одну настройку для Claude, Codex и других клиентов. CX Codex ★ 1 596звёзд репо agentmart Плагин agentmart подключает удалённый MCP-сервер с готовой инфраструктурой для агентов: очередями, вебхуками и хранилищем памяти. Выручает, когда проекту нужны фоновые сервисы вне активной сессии. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой