delegate

Antigravity Delegate

Delegate $ARGUMENTS to the antigravity-preview-05-2026 managed agent in a remote Gemini sandbox, wait for it to finish, and report the result.

The script is at ${CLAUDE_PLUGIN_ROOT}/scripts/antigravity.py. It is self-daemonizing: delegate returns immediately with a run_id, a detached worker performs the interaction, and a status file flips to completed / failed when done. Requires GEMINI_API_KEY in the environment and uv on PATH.

Phase 1: Parse arguments

Goal: Separate the task prompt from flags.

Actions:

1. Treat the leading free text of $ARGUMENTS (before any --flag) as the task prompt.
2. Recognize optional flags and pass them through unchanged:
   • --tools — comma list of code_execution, google_search, url_context (default: all three)
   • --network — default (open outbound, the default) or none (sandbox code cannot reach the internet; Google Search and URL reading still work)
   • --repo URL — mount a GitHub repository at /workspace/repo
3. If the prompt is empty, ask the user what to delegate and stop.

Phase 2: Launch the run

Goal: Start the detached worker and capture its handles.

Actions:

1. Run the script with the parsed prompt and flags:

   uv run "${CLAUDE_PLUGIN_ROOT}/scripts/antigravity.py" delegate --prompt "<task>" [flags]
   

2. Capture run_id, output_file, and wait_command from stdout.
3. If stdout reports an error (for example a missing GEMINI_API_KEY), surface it and stop.

Phase 3: Wait for completion

Goal: Block until the run reaches a terminal state without busy-looping the model.

Actions:

1. Start a Monitor on the captured wait_command. It emits exactly one line — antigravity run <id>: completed or ... failed (or ... timeout) — then exits:

   uv run "${CLAUDE_PLUGIN_ROOT}/scripts/antigravity.py" wait --run <run_id> --timeout 900
   

   Set the Monitor timeout_ms to 1800000 (30 min, 2x the wait timeout) and a clear description such as "antigravity delegate <run_id>".
2. When the Monitor event arrives, check if the line contains : completed, : failed, or : timeout:
   • Contains : completed or : failed → proceed to Phase 4.
   • Contains : timeout → the run is NOT done; the detached worker is still going. Start the Monitor on the same wait_command again to keep waiting. After four consecutive timeouts (2 hours total), tell the user it is still running and give them the full command to fetch it later:

     uv run "${CLAUDE_PLUGIN_ROOT}/scripts/antigravity.py" status --run <run_id> --full
     

     then stop. Never present a timeout / still-running state as the result. Do not poll manually in a loop.