AI Mobile Codex Plugin

Created by comprono.

AI Mobile is a community Codex MCP plugin for Windows. It lets Codex coordinate local AI workers from a mobile-started workflow: Antigravity CLI for low-RAM project work, Antigravity desktop for visible project/chat state, Claude Code for headless code/review lanes, and Cursor when a real headless cursor-agent is available.

The goal is orchestration, not just token saving. Codex acts as the team lead: it checks task shape and exposed capacity, assigns lanes, starts workers, reads compact artifacts, resolves conflicts, verifies, and summarizes.

Core Flow

For one-lane work:

powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" run-efficient-task -Goal "<goal>" -Workspace "<path>" -Mode fast

For larger team work:

powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" team-orchestration-plan -Goal "<goal>" -Workspace "<path>" -TaskSplit "UI, backend, testing" -HorizonHours 5
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" run-team-task -Goal "<goal>" -Workspace "<path>" -TaskSplit "UI, backend, testing" -Mode patch -HorizonHours 5

Workers write compact artifacts under:

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

Codex should read those artifacts instead of watching full chats, logs, or source dumps.

Install

git clone https://github.com/comprono/Ai-Mobile-Codex-plugin.git "$env:USERPROFILE\plugins\ai-mobile"
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" setup

Requirements:

• Windows.
• Codex plugins loaded from %USERPROFILE%\plugins.
• Node.js on PATH.
• Antigravity desktop at %LOCALAPPDATA%\Programs\Antigravity\Antigravity.exe.
• Optional: Antigravity CLI as agy.
• Optional: Claude Code CLI as claude.
• Optional: Cursor; headless jobs require a real cursor-agent binary.

Main Commands

# Health and capacity
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" quick
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" models
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" limits-summary

# Team planning and execution
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" orchestration-plan -Goal "<goal>" -Workspace "<path>"
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" team-orchestration-plan -Goal "<goal>" -Workspace "<path>" -TaskSplit "UI, backend, testing"
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" run-team-task -Goal "<goal>" -Workspace "<path>" -TaskSplit "UI, backend, testing"

# Worker lanes
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" submit-agy-job -Goal "<goal>" -Workspace "<path>" -Mode review
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" submit-claude-job -Goal "<goal>" -Workspace "<path>" -Mode patch -ClaudeModel sonnet
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" read-job -Workspace "<path>" -JobId latest

# Visible Antigravity UI only when needed
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" open
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" live
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" select-chat -ExpectedProject "<project>" -ExpectedChat "<chat>"
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\plugins\ai-mobile\scripts\antigravity.ps1" switch-model -ModelPreference flash-medium -ExpectedProject "<project>" -ExpectedChat "<chat>"

MCP Servers

• ai-mobile-local: setup, status, capacity, team orchestration, durable jobs, model switching, worker submission, job readback, and privacy scan.
• ai-mobile-devtools: Chromium DevTools bridge for live Antigravity UI inspection and interaction.

Important local tools include quick, models, limits-summary, orchestration-plan, team-orchestration-plan, run-team-task, run-efficient-task, submit-agy-job, submit-claude-job, submit-job, read-job, select-chat, switch-model, devtools-health, and privacy.

Operating Rules

• Startup is passive. Opening Codex must not open, close, restart, or repair Antigravity.
• Use Antigravity CLI before desktop UI when visible project/chat state is not required.
• Use Antigravity desktop only for visible project/chat/model/composer workflows.
• Use Claude Code for local code, review, patch, and test lanes when UI context is not required.
• Treat “Claude/Sonnet/Opus in an Antigravity chat” as an Antigravity model choice, not Claude Code CLI.
• Do not submit into an existing chat unless expectedChat matches the active Antigravity document title/context.
• Do not report a submitted task unless the helper returns Submitted: true or a worker job returns Started: true.
• If DevTools says Transport closed, call devtools-health once; do not keep retrying list_pages.

Capacity Limits

The plugin can read Antigravity model availability from the local Antigravity language server when Antigravity exposes it. Codex and Claude Code do not expose private remaining-token ledgers through this plugin, so the team planner uses caller-provided Codex budget text and Claude Code availability/version only.

Safety

This is a local bridge. It does not patch Antigravity internals, bypass model quotas, commit runtime tokens, or read private chats unless the user asks for that specific context.

Before publishing:

powershell -ExecutionPolicy Bypass -File ".\scripts\antigravity.ps1" privacy
git diff --check
python -m pipx run plugin-scanner lint .
python -m pipx run plugin-scanner verify .

plugin-scanner verify may report skipped stdio execution for safety; manually test the MCP server or PowerShell helper when that happens.

License

MIT