Antigravity CLI Delegate

Antigravity CLI Delegate

Use Antigravity CLI as a secondary worker. Codex remains the orchestrator and must inspect Antigravity's output before acting on it.

Install

npx skills add DevBD1/skills --skill antigravity-cli-delegate

Default Rules

• Prefer bounded headless delegation through agy --print.
• Use the wrapper's JSON output so Codex can parse response and conversation metadata.
• Resolve the wrapper relative to the installed skill directory, then run scripts/antigravity_delegate.py. If the host agent sandboxes network, auth, local callbacks, or long-running commands, request the narrow approval needed for that wrapper command.
• Do not use agy --dangerously-skip-permissions.
• Do not treat Antigravity output as source of truth. Verify claims against files, commands, docs, or tests.
• Do not let Antigravity make changes unless the user explicitly asks for implementation delegation or an interactive Antigravity session.
• For deterministic crawling or scraping, prefer existing Codex/web/crawl4ai paths unless the user asks Antigravity to handle the research.

Task Routing

The wrapper accepts --task-class heavy|medium|simple for Codex-side metadata only. Current agy --help exposes no model-selection flag, so task class is not passed to Antigravity.

Prefer medium when unsure.

Helper Script

Use the bundled wrapper for repeatable calls:

python3 <skill-dir>/scripts/antigravity_delegate.py \
  --task-class medium \
  --prompt "Review this plan for missing risks."

Pipe context through stdin when useful:

git diff --staged | python3 <skill-dir>/scripts/antigravity_delegate.py \
  --task-class medium \
  --prompt "Review this diff. Return findings with file, line, risk, and fix."

The wrapper calls Antigravity roughly as:

agy --print "<prompt>" --print-timeout 300s

For Codex, the wrapper returns JSON:

{
  "conversation_id": "conversation-id",
  "response": "Antigravity response text",
  "task_class": "medium",
  "cwd": "/path/to/workspace",
  "command": ["agy", "--print", "..."]
}

Long Chat Sessions

Use named chats when the user wants a long Antigravity conversation or follow-up turns over time. Named chats are local aliases stored in ~/.antigravity-cli-delegate/sessions.json by default. Override with --state-dir or ANTIGRAVITY_DELEGATE_STATE_DIR.

Start or resume a named chat:

python3 <skill-dir>/scripts/antigravity_delegate.py \
  --chat ai-coding-trends \
  --task-class medium \
  --prompt "Start a thread about recent AI-assisted coding trends."

Continue the same named chat:

python3 <skill-dir>/scripts/antigravity_delegate.py \
  --chat ai-coding-trends \
  --prompt "Go deeper on IDE agent workflows."

Continue the latest Antigravity conversation:

python3 <skill-dir>/scripts/antigravity_delegate.py \
  --continue-latest \
  --prompt "Continue from the latest Antigravity session."

Use an explicit Antigravity conversation ID:

python3 <skill-dir>/scripts/antigravity_delegate.py \
  --conversation 00000000-0000-0000-0000-000000000000 \
  --prompt "Continue this exact Antigravity conversation."

List local named chats:

python3 <skill-dir>/scripts/antigravity_delegate.py \
  --list-chats

Forget a local alias without deleting Antigravity's native conversation:

python3 <skill-dir>/scripts/antigravity_delegate.py \
  --forget-chat ai-coding-trends

Use live interactive Antigravity only when the user wants a human-style CLI chat:

python3 <skill-dir>/scripts/antigravity_delegate.py \
  --chat ai-coding-trends \
  --interactive \
  --prompt "Open this thread interactively."

Interactive mode uses agy --prompt-interactive, does not return wrapper JSON, and lets Antigravity own stdout/stderr.

Delegation Patterns

For planning, brainstorming, reviews, research, and large-context analysis:

python3 <skill-dir>/scripts/antigravity_delegate.py \
  --cwd /path/to/repo \
  --task-class heavy \
  --timeout 300 \
  --prompt "Analyze this codebase read-only and identify the highest-risk implementation path."

For additional workspace directories:

python3 <skill-dir>/scripts/antigravity_delegate.py \
  --cwd /path/to/repo \
  --add-dir /path/to/extra/context \
  --prompt "Review the repo with the extra context directory."

For plugin status checks:

agy plugin list

Expected imported plugins after the Gemini migration include postgres and snitch.

Smoke Tests

agy --version
PYTHONPYCACHEPREFIX=/private/tmp/antigravity-delegate-pycache python3 -m py_compile <skill-dir>/scripts/antigravity_delegate.py
python3 <skill-dir>/scripts/antigravity_delegate.py --list-chats --state-dir /private/tmp/antigravity-delegate-smoke
python3 <skill-dir>/scripts/antigravity_delegate.py --task-class simple --prompt "Reply exactly: AGY_PRINT_OK"
python3 <skill-dir>/scripts/antigravity_delegate.py --chat smoke-antigravity --prompt "Reply exactly: AGY_CHAT_START_OK"
python3 <skill-dir>/scripts/antigravity_delegate.py --chat smoke-antigravity --prompt "Reply exactly: AGY_CHAT_CONTINUE_OK"
python3 <skill-dir>/scripts/antigravity_delegate.py --forget-chat smoke-antigravity
agy plugin list