feat: add Antigravity CLI and Gemini environment support

commands/adversarial-review.toml

@@ -0,0 +1,11 @@
+description = "Runs a steerable review that questions the chosen implementation and design"
+prompt = """
+You are the adversarial-review command handler for the Codex plugin on Antigravity CLI.
+Your goal is to run a steerable, pressure-testing review of design choices, tradeoffs, hidden assumptions, or risk areas.
+
+Please find the companion script `codex-companion.mjs` under the `plugins/codex/scripts/` directory in the current workspace.
+Execute the following command using the `run_command` tool:
+`node "<path to codex-companion.mjs>" adversarial-review {{args}}`
+
+Present the review results exactly as-is to the user.
+"""

commands/cancel.toml

@@ -0,0 +1,11 @@
+description = "Cancel an ongoing background Codex job"
+prompt = """
+You are the cancel command handler for the Codex plugin on Antigravity CLI.
+Your goal is to cancel a running background job.
+
+Please find the companion script `codex-companion.mjs` under the `plugins/codex/scripts/` directory in the current workspace.
+Execute the following command using the `run_command` tool:
+`node "<path to codex-companion.mjs>" cancel {{args}}`
+
+Present the output exactly as-is to the user.
+"""

commands/rescue.toml

@@ -0,0 +1,21 @@
+description = "Delegate investigation, an explicit fix request, or follow-up rescue work to the Codex rescue process"
+prompt = """
+You are the rescue command handler for the Codex plugin on Antigravity CLI.
+Your goal is to delegate coding, debugging, or investigation tasks to the Codex rescue companion.
+
+Please find the companion script `codex-companion.mjs` under the `plugins/codex/scripts/` directory in the current workspace.
+
+First, check if there is a resumable rescue candidate from the current session by running:
+`node "<path to codex-companion.mjs>" task-resume-candidate --json`
+
+If the result shows a candidate is available, ask the user if they want to:
+1. "Continue current Codex thread" (Recommended if they are asking to continue, keep going, resume, apply the top fix, or dig deeper)
+2. "Start a new Codex thread" (Recommended otherwise)
+
+Then, run the task using the `run_command` tool:
+`node "<path to codex-companion.mjs>" task {{args}}`
+(Add `--resume-last` if they chose to continue the thread, or `--fresh` for a new one).
+
+If the user request includes `--background`, let the command run in the background.
+Return the stdout verbatim to the user without summarizing or rewriting.
+"""

commands/result.toml

@@ -0,0 +1,11 @@
+description = "Fetch and display the final result of a completed background Codex job"
+prompt = """
+You are the result command handler for the Codex plugin on Antigravity CLI.
+Your goal is to fetch and print the final result of a background job.
+
+Please find the companion script `codex-companion.mjs` under the `plugins/codex/scripts/` directory in the current workspace.
+Execute the following command using the `run_command` tool:
+`node "<path to codex-companion.mjs>" result {{args}}`
+
+Present the output exactly as-is to the user.
+"""

commands/review.toml

@@ -0,0 +1,11 @@
+description = "Runs a normal Codex review on your current work"
+prompt = """
+You are the review command handler for the Codex plugin on Antigravity CLI.
+Your goal is to run a normal, read-only Codex review on the current uncommitted changes or branch comparison.
+
+Please find the companion script `codex-companion.mjs` under the `plugins/codex/scripts/` directory in the current workspace.
+Execute the following command using the `run_command` tool:
+`node "<path to codex-companion.mjs>" review {{args}}`
+
+Present the review results exactly as-is to the user.
+"""

commands/setup.toml

@@ -0,0 +1,14 @@
+description = "Check whether the local Codex CLI is ready and optionally toggle the stop-time review gate"
+prompt = """
+You are the setup command handler for the Codex plugin on Antigravity CLI.
+Your goal is to run the setup process.
+
+Please find the companion script `codex-companion.mjs` under the `plugins/codex/scripts/` directory in the current workspace.
+Execute the following command using the `run_command` tool:
+`node "<path to codex-companion.mjs>" setup --json {{args}}`
+
+After executing the command:
+1. Parse the JSON output returned by the command.
+2. If the output indicates that Codex is unavailable and npm is available, ask the user if they want to install it. If they choose to, run `npm install -g @openai/codex` and then rerun the setup command.
+3. Present the setup results beautifully to the user.
+"""

commands/status.toml

@@ -0,0 +1,11 @@
+description = "Check progress on ongoing or completed background Codex jobs"
+prompt = """
+You are the status command handler for the Codex plugin on Antigravity CLI.
+Your goal is to check the progress or status of background jobs.
+
+Please find the companion script `codex-companion.mjs` under the `plugins/codex/scripts/` directory in the current workspace.
+Execute the following command using the `run_command` tool:
+`node "<path to codex-companion.mjs>" status {{args}}`
+
+Present the output exactly as-is to the user.
+"""

gemini-extension.json

@@ -0,0 +1,6 @@
+{
+  "name": "codex",
+  "version": "1.0.4",
+  "description": "Use Codex from Antigravity CLI to review code or delegate tasks.",
+  "contextFileName": "GEMINI.md"
+}

package.json

@@ -1,9 +1,9 @@
 {
-  "name": "@openai/codex-plugin-cc",
+  "name": "@openai/codex-plugin-agy",
   "version": "1.0.4",
   "private": true,
   "type": "module",
-  "description": "Use Codex from Claude Code to review code or delegate tasks.",
+  "description": "Use Codex from Antigravity CLI to review code or delegate tasks.",
   "license": "Apache-2.0",
   "engines": {
     "node": ">=18.18.0"

plugins/codex/prompts/stop-review-gate.md

@@ -1,11 +1,11 @@
 <task>
-Run a stop-gate review of the previous Claude turn.
-Only review the work from the previous Claude turn.
-Only review it if Claude actually did code changes in that turn.
+Run a stop-gate review of the previous Antigravity turn.
+Only review the work from the previous Antigravity turn.
+Only review it if Antigravity actually did code changes in that turn.
 Pure status, setup, or reporting output does not count as reviewable work.
 For example, the output of /codex:setup or /codex:status does not count.
 Only direct edits made in that specific turn count.
-If the previous Claude turn was only a status update, a summary, a setup/login check, a review result, or output from a command that did not itself make direct edits in that turn, return ALLOW immediately and do no further work.
+If the previous Antigravity turn was only a status update, a summary, a setup/login check, a review result, or output from a command that did not itself make direct edits in that turn, return ALLOW immediately and do no further work.
 Challenge whether that specific work and its design choices should ship.
 
 {{CLAUDE_RESPONSE_BLOCK}}
@@ -27,7 +27,7 @@ Use BLOCK only if the previous turn made code changes and you found something th
 
 <grounding_rules>
 Ground every blocking claim in the repository context or tool outputs you inspected during this run.
-Do not treat the previous Claude response as proof that code changes happened; verify that from the repository state before you block.
+Do not treat the previous Antigravity response as proof that code changes happened; verify that from the repository state before you block.
 Do not block based on older edits from earlier turns when the immediately previous turn did not itself make direct edits.
 </grounding_rules>
 

plugins/codex/scripts/codex-companion.mjs

@@ -68,7 +68,7 @@ const DEFAULT_STATUS_WAIT_TIMEOUT_MS = 240000;
 const DEFAULT_STATUS_POLL_INTERVAL_MS = 2000;
 const VALID_REASONING_EFFORTS = new Set(["none", "minimal", "low", "medium", "high", "xhigh"]);
 const MODEL_ALIASES = new Map([["spark", "gpt-5.3-codex-spark"]]);
-const STOP_REVIEW_TASK_MARKER = "Run a stop-gate review of the previous Claude turn.";
+const STOP_REVIEW_TASK_MARKER = "Run a stop-gate review of the previous Antigravity turn.";
 
 function printUsage() {
   console.log(
@@ -289,7 +289,7 @@ function isActiveJobStatus(status) {
 }
 
 function getCurrentClaudeSessionId() {
-  return process.env[SESSION_ID_ENV] ?? null;
+  return process.env[SESSION_ID_ENV] ?? process.env.ANTIGRAVITY_TRAJECTORY_ID ?? process.env.GEMINI_TRAJECTORY_ID ?? null;
 }
 
 function filterJobsForCurrentClaudeSession(jobs) {
@@ -538,7 +538,7 @@ function buildTaskRunMetadata({ prompt, resumeLast = false }) {
   if (!resumeLast && String(prompt ?? "").includes(STOP_REVIEW_TASK_MARKER)) {
     return {
       title: "Codex Stop Gate Review",
-      summary: "Stop-gate review of previous Claude turn"
+      summary: "Stop-gate review of previous Antigravity turn"
     };
   }
 

plugins/codex/scripts/lib/app-server.mjs

@@ -25,7 +25,7 @@ export const BROKER_BUSY_RPC_CODE = -32001;
 /** @type {ClientInfo} */
 const DEFAULT_CLIENT_INFO = {
   title: "Codex Plugin",
-  name: "Claude Code",
+  name: "Antigravity CLI",
   version: PLUGIN_MANIFEST.version ?? "0.0.0"
 };
 

plugins/codex/scripts/lib/codex.mjs

@@ -39,7 +39,7 @@ import { BROKER_BUSY_RPC_CODE, BROKER_ENDPOINT_ENV, CodexAppServerClient } from
 import { loadBrokerSession } from "./broker-lifecycle.mjs";
 import { binaryAvailable } from "./process.mjs";
 
-const SERVICE_NAME = "claude_code_codex_plugin";
+const SERVICE_NAME = "antigravity_cli_codex_plugin";
 const TASK_THREAD_PREFIX = "Codex Companion Task";
 const DEFAULT_CONTINUE_PROMPT =
   "Continue from the current thread state. Pick the next highest-value step and follow through until the task is resolved.";
@@ -815,7 +815,7 @@ export function getSessionRuntimeStatus(env = process.env, cwd = process.cwd())
     return {
       mode: "shared",
       label: "shared session",
-      detail: "This Claude session is configured to reuse one shared Codex runtime.",
+      detail: "This Antigravity session is configured to reuse one shared Codex runtime.",
       endpoint
     };
   }

plugins/codex/scripts/lib/job-control.mjs

@@ -13,7 +13,8 @@ export function sortJobsNewestFirst(jobs) {
 }
 
 function getCurrentSessionId(options = {}) {
-  return options.env?.[SESSION_ID_ENV] ?? process.env[SESSION_ID_ENV] ?? null;
+  const env = options.env ?? process.env;
+  return env[SESSION_ID_ENV] ?? env.ANTIGRAVITY_TRAJECTORY_ID ?? env.GEMINI_TRAJECTORY_ID ?? null;
 }
 
 function filterJobsForCurrentSession(jobs, options = {}) {

plugins/codex/scripts/lib/state.mjs

@@ -6,7 +6,7 @@ import path from "node:path";
 import { resolveWorkspaceRoot } from "./workspace.mjs";
 
 const STATE_VERSION = 1;
-const PLUGIN_DATA_ENV = "CLAUDE_PLUGIN_DATA";
+const PLUGIN_DATA_ENV = process.env.ANTIGRAVITY_PLUGIN_DATA ? "ANTIGRAVITY_PLUGIN_DATA" : (process.env.GEMINI_PLUGIN_DATA ? "GEMINI_PLUGIN_DATA" : "CLAUDE_PLUGIN_DATA");
 const FALLBACK_STATE_ROOT_DIR = path.join(os.tmpdir(), "codex-companion");
 const STATE_FILE_NAME = "state.json";
 const JOBS_DIR_NAME = "jobs";

plugins/codex/scripts/lib/tracked-jobs.mjs

@@ -59,7 +59,7 @@ export function createJobLogFile(workspaceRoot, jobId, title) {
 
 export function createJobRecord(base, options = {}) {
   const env = options.env ?? process.env;
-  const sessionId = env[options.sessionIdEnv ?? SESSION_ID_ENV];
+  const sessionId = env[options.sessionIdEnv ?? SESSION_ID_ENV] ?? env.ANTIGRAVITY_TRAJECTORY_ID ?? env.GEMINI_TRAJECTORY_ID ?? null;
   return {
     ...base,
     createdAt: nowIso(),

plugins/codex/scripts/session-lifecycle-hook.mjs

@@ -17,7 +17,7 @@ import { loadState, resolveStateFile, saveState } from "./lib/state.mjs";
 import { resolveWorkspaceRoot } from "./lib/workspace.mjs";
 
 export const SESSION_ID_ENV = "CODEX_COMPANION_SESSION_ID";
-const PLUGIN_DATA_ENV = "CLAUDE_PLUGIN_DATA";
+const PLUGIN_DATA_ENV = process.env.ANTIGRAVITY_PLUGIN_DATA ? "ANTIGRAVITY_PLUGIN_DATA" : (process.env.GEMINI_PLUGIN_DATA ? "GEMINI_PLUGIN_DATA" : "CLAUDE_PLUGIN_DATA");
 
 function readHookInput() {
   const raw = fs.readFileSync(0, "utf8").trim();
@@ -32,10 +32,11 @@ function shellEscape(value) {
 }
 
 function appendEnvVar(name, value) {
-  if (!process.env.CLAUDE_ENV_FILE || value == null || value === "") {
+  const envFile = process.env.ANTIGRAVITY_ENV_FILE || process.env.GEMINI_ENV_FILE || process.env.CLAUDE_ENV_FILE;
+  if (!envFile || value == null || value === "") {
     return;
   }
-  fs.appendFileSync(process.env.CLAUDE_ENV_FILE, `export ${name}=${shellEscape(value)}\n`, "utf8");
+  fs.appendFileSync(envFile, `export ${name}=${shellEscape(value)}\n`, "utf8");
 }
 
 function cleanupSessionJobs(cwd, sessionId) {

plugins/codex/scripts/stop-review-gate-hook.mjs

@@ -16,7 +16,7 @@ import { resolveWorkspaceRoot } from "./lib/workspace.mjs";
 const STOP_REVIEW_TIMEOUT_MS = 15 * 60 * 1000;
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 const ROOT_DIR = path.resolve(SCRIPT_DIR, "..");
-const STOP_REVIEW_TASK_MARKER = "Run a stop-gate review of the previous Claude turn.";
+const STOP_REVIEW_TASK_MARKER = "Run a stop-gate review of the previous Antigravity turn.";
 
 function readHookInput() {
   const raw = fs.readFileSync(0, "utf8").trim();
@@ -48,11 +48,11 @@ function filterJobsForCurrentSession(jobs, input = {}) {
 function buildStopReviewPrompt(input = {}) {
   const lastAssistantMessage = String(input.last_assistant_message ?? "").trim();
   const template = loadPromptTemplate(ROOT_DIR, "stop-review-gate");
-  const claudeResponseBlock = lastAssistantMessage
-    ? ["Previous Claude response:", lastAssistantMessage].join("\n")
+  const antigravityResponseBlock = lastAssistantMessage
+    ? ["Previous Antigravity response:", lastAssistantMessage].join("\n")
     : "";
   return interpolateTemplate(template, {
-    CLAUDE_RESPONSE_BLOCK: claudeResponseBlock
+    CLAUDE_RESPONSE_BLOCK: antigravityResponseBlock
   });
 }
 
@@ -141,7 +141,7 @@ function runStopReview(cwd, input = {}) {
 
 function main() {
   const input = readHookInput();
-  const cwd = input.cwd || process.env.CLAUDE_PROJECT_DIR || process.cwd();
+  const cwd = input.cwd || process.env.ANTIGRAVITY_PROJECT_DIR || process.env.GEMINI_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.cwd();
   const workspaceRoot = resolveWorkspaceRoot(cwd);
   const config = getConfig(workspaceRoot);
 

tests/fake-codex-fixture.mjs

@@ -217,7 +217,7 @@ function structuredReviewPayload(prompt) {
 }
 
 function taskPayload(prompt, resume) {
-  if (prompt.includes("<task>") && prompt.includes("Only review the work from the previous Claude turn.")) {
+  if (prompt.includes("<task>") && prompt.includes("Only review the work from the previous Antigravity turn.")) {
     if (BEHAVIOR === "adversarial-clean") {
       return "ALLOW: No blocking issues found in the previous turn.";
     }

tests/runtime.test.mjs

@@ -3,7 +3,7 @@ import path from "node:path";
 import test from "node:test";
 import assert from "node:assert/strict";
 import { spawn } from "node:child_process";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 import { buildEnv, installFakeCodex } from "./fake-codex-fixture.mjs";
 import { initGitRepo, makeTempDir, run } from "./helpers.mjs";
@@ -44,6 +44,18 @@ test("setup reports ready when fake codex is installed and authenticated", () =>
   assert.equal(payload.sessionRuntime.mode, "direct");
 });
 
+test("app-server module loads from the shipped plugin directory", async () => {
+  const installRoot = makeTempDir();
+  const installedPluginRoot = path.join(installRoot, "codex");
+  fs.cpSync(PLUGIN_ROOT, installedPluginRoot, { recursive: true });
+
+  const moduleUrl = pathToFileURL(path.join(installedPluginRoot, "scripts", "lib", "app-server.mjs"));
+  moduleUrl.search = `?test=${Date.now()}`;
+  const appServerModule = await import(moduleUrl.href);
+
+  assert.equal(typeof appServerModule.CodexAppServerClient?.connect, "function");
+});
+
 test("setup is ready without npm when Codex is already installed and authenticated", () => {
   const binDir = makeTempDir();
   installFakeCodex(binDir);
@@ -1829,7 +1841,8 @@ test("stop hook runs a stop-time review task and blocks on findings when the rev
   const fakeState = JSON.parse(fs.readFileSync(fakeStatePath, "utf8"));
   assert.match(fakeState.lastTurnStart.prompt, /<task>/i);
   assert.match(fakeState.lastTurnStart.prompt, /<compact_output_contract>/i);
-  assert.match(fakeState.lastTurnStart.prompt, /Only review the work from the previous Claude turn/i);
+  assert.match(fakeState.lastTurnStart.prompt, /Only review the work from the previous Antigravity turn/i);
+  assert.match(fakeState.lastTurnStart.prompt, /Previous Antigravity response:/);
   assert.match(fakeState.lastTurnStart.prompt, /I completed the refactor and updated the retry logic\./);
 
   const status = run("node", [SCRIPT, "status"], {

tests/tests/broker-endpoint.test.mjs

@@ -0,0 +1,22 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+
+import { createBrokerEndpoint, parseBrokerEndpoint } from "../plugins/codex/scripts/lib/broker-endpoint.mjs";
+
+test("createBrokerEndpoint uses Unix sockets on non-Windows platforms", () => {
+  const endpoint = createBrokerEndpoint("/tmp/cxc-12345", "darwin");
+  assert.equal(endpoint, "unix:/tmp/cxc-12345/broker.sock");
+  assert.deepEqual(parseBrokerEndpoint(endpoint), {
+    kind: "unix",
+    path: "/tmp/cxc-12345/broker.sock"
+  });
+});
+
+test("createBrokerEndpoint uses named pipes on Windows", () => {
+  const endpoint = createBrokerEndpoint("C:\\\\Temp\\\\cxc-12345", "win32");
+  assert.equal(endpoint, "pipe:\\\\.\\pipe\\cxc-12345-codex-app-server");
+  assert.deepEqual(parseBrokerEndpoint(endpoint), {
+    kind: "pipe",
+    path: "\\\\.\\pipe\\cxc-12345-codex-app-server"
+  });
+});