antigravity-call-codex git:20260911.768b0a6A

Immutable. This exact content is served forever at /api/v1/blob/d8fd3e3f1a2acdde.

---
name: antigravity-call-codex
description: Use when delegating tasks to Codex to automatically execute code, edit files, and run tests directly on the repository via native MCP.
---

# Integrate Codex into Antigravity via Native MCP

## Purpose

Enable Antigravity to delegate end-to-end technical tasks to Codex to execute directly on the repository via the Model Context Protocol (MCP).

Codex possesses full tools to read/write files and execute shell commands, autonomously closing the self-repair loop (edit → build → test → pass) without requiring Antigravity to act as an intermediary for copying and pasting code.

---

## 1. Local Global MCP Configuration (One-time Setup)

To make the MCP Server active across all Antigravity workspaces on this machine, declare it in Antigravity's Global configuration file:

* **Windows Path:** `C:\Users\<USER>\.gemini\config\mcp_config.json` (shorthand: `~/.gemini/config/mcp_config.json`)
* **Configuration Content (YOLO Mode - Full execution permissions for Codex):**

```json
{
  "mcpServers": {
    "codex": {
      "command": "codex.cmd",
      "args": [
        "--dangerously-bypass-approvals-and-sandbox",
        "--dangerously-bypass-hook-trust",
        "mcp-server"
      ]
    }
  }
}
```

* **Verify Status:** In the Antigravity UI, navigate to **Additional Options (`...`) > MCP Servers** to confirm `codex` shows a connected state with 2 tools: `codex` and `codex-reply`.

---

## 2. How the Agent Invokes Codex via MCP

Antigravity invokes the native MCP tool directly (via `call_mcp_tool` or native function call):

### Initialize a new session (`Tool: codex`)

* **ServerName:** `codex`
* **ToolName:** `codex`
* **Arguments:**

```json
{
  "prompt": "Detailed description of the task to execute",
  "cwd": "<root_directory_path_of_the_target_repository>"
}
```