codex-gravity
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GEMINI_API_KEY | No | Gemini API key used by the antigravity/antigravity-pro transports when no local CLI is available. | |
| GOOGLE_API_KEY | No | Google API key used by the antigravity/antigravity-pro transports when no local CLI is available. | |
| CODEX_GRAVITY_CODEX_BIN | No | Path to the codex executable for the codex-cli/codex transports; otherwise resolved from PATH. | |
| CODEX_APP_TOOLS_PIPE_PATH | No | Pipe path injected by the ChatGPT/Codex desktop app; required for the codex-gui transport. | |
| CODEX_GRAVITY_STUDIO_TOKEN | No | Token required in the X-Codex-Gravity-Token header for HTTP routes that execute commands. | |
| CODEX_GRAVITY_STUDIO_TOOLS | No | Allowlist of tools permitted on the HTTP studio execution routes. | |
| CODEX_GRAVITY_ANTIGRAVITY_CLI_BIN | No | Path to the agentapi/agy executable for the antigravity-cli transport. | |
| CODEX_GRAVITY_ANTIGRAVITY_CLI_CMD | No | Command template for antigravity-cli when the distribution uses different flags, e.g. 'agy ask --model flash {prompt}'. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| antigravity_gui_statusB | Inspect the real local Antigravity GUI: current model, busy state, and unsent draft. No CLI or API fallback. |
| antigravity_gui_start_taskC | Send a scoped task to the real Antigravity GUI. Optionally watch completion and notify the exact existing Codex chat. No CLI/API fallback for Antigravity. |
| antigravity_gui_task_statusC | Read the owned GUI task. ready_for_review means its turn ended, not that code/tests passed. |
| antigravity_gui_followupA | Send corrections to the same completed GUI task. Pass notify_codex_thread_id to watch the new round. Refuses busy chats, model changes and unsent drafts. |
| codex_gravity_watch_completionB | Register/resume a detached completion watch for an owned Antigravity task and exact existing Codex thread UUID. Explicitly authorizes one completion follow-up for this round. Waits while Codex is busy; never silently retries uncertain delivery. |
| codex_gravity_completion_statusB | Read a persisted completion watch without sending a message. notified means desktop accepted a follow-up, not review success. |
| codex_gravity_cancel_completionA | Cancel a completion watch. Does not cancel Antigravity or recall an already submitted Codex message. |
| team_agentsB | List team agent transports (codex CLI, codex-gui desktop app, antigravity, antigravity-gui) and whether each is reachable right now. |
| team_run_taskB | Run a two-way Codex+Antigravity team: plan, adversarial review, cross-examination, revision, consensus and an optional real verification command. Pass codex_thread to use the ChatGPT/Codex desktop app instead of the CLI. Reports unavailable, deadlocked or failed honestly. |
| team_statusB | Read a team session: running/finished, last message, decision and transcript path. Never reconstructs a missing session. |
| team_transcriptC | Read a team session transcript as JSON messages or rendered Markdown. |
| team_send_messageA | Send a message into a team session as 'human' or another agent (kinds: note, question, answer, critique, approval, rejection). Delivered live when the session runs in this process, otherwise stored for audit. |
| team_cancelA | Request cancellation of a team session running in this MCP process. In-flight agent turns finish; no new round starts. |
| team_reportB | Render a team session (or diff review) as one self-contained HTML file with the verdict, blockers, verification output and full transcript. Returns the written path. |
| team_compareB | Compare two team sessions: status change, resolved/new blockers, approvals and the proposal diff. Defaults to the two most recent sessions. |
| team_decisionsB | Read the project decision log (.codex-gravity/decisions.md): the accepted decisions later sessions are given as context. |
| codex_gui_statusA | Inspect the ChatGPT/Codex desktop app: its live app-tools catalogue, the chat's busy state, turn count and last message. Read-only; requires running inside the Codex desktop app. |
| codex_gui_askB | Send one message to an exact existing ChatGPT/Codex desktop chat and wait for the new completed reply. Returns status=unconfirmed when no reply can be observed; it never guesses and never resends. |
| antigravity_inspect_mediaB | Reads local video/audio/image metadata via ffprobe and, when a model is configured, asks it for an analysis. Returns status=partial when only metadata was read. |
| antigravity_distill_contextC | Reads massive directories or 100k+ line logs and distills down to AST code blocks and pinpointed issue context. |
| antigravity_verify_and_screenshotC | Executes test command in terminal and inspects multi-viewport UI layout. |
| call_antigravity_verifierC | Symmetrical tool: Request Antigravity terminal verification and visual regression checks. |
| call_codex_architectA | Ask the real signed-in Codex CLI for a bounded read-only code/architecture answer. Uses the configured model; no synthetic fallback or provider API. Does not create a persistent chat or edit files. |
| call_antigravity_multimodalC | Symmetrical tool: Codex requests Google Antigravity (Gemini Flash via active subscription) for media or context distillation. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 24 tools
Several tools have overlapping purposes: antigravity_verify_and_screenshot vs call_antigravity_verifier, antigravity_gui_task_status vs codex_gravity_completion_status, and codex_gui_ask vs call_codex_architect are easy to confuse. Descriptions are detailed but the boundaries between direct GUI control, verifier calls, and completion watches remain unclear.
The set mixes multiple conventions: antigravity_*, call_*, codex_gui_*, codex_gravity_*, and team_*, with verbs appearing sometimes first, sometimes last. Names like antigravity_verify_and_screenshot and codex_gravity_watch_completion are readable but do not follow a predictable verb_noun pattern.
At 24 tools this is heavy for an orchestration bridge, and several status/cancel/watch tools feel like separate surface areas rather than distinct capabilities. The count is borderline but not extreme for a two-agent coordination system.
Core workflows are covered: task start, status, follow-up, completion watches, team sessions, transcripts, reports, and decision logs. However, there is no explicit cancel/stop for an Antigravity GUI task and no obvious session-listing operation, leaving notable gaps in lifecycle coverage.