Delegate bounded coding tasks to Antigravity CLI and review

Lets an orchestrating coding agent (you) hand a bounded coding task to Google Antigravity's CLI (agy), acting as a separate implementer, then review what it produced and land it yourself. You write the brief and own the judgment; Antigravity does the typing in its own conversation; you verify and commit. The five-step loop is: write the brief, dispatch it, wait for completion, review without trusting the self-report, and land the verified work. Dispatch runs through the bundled scripts/relay.mjs, which wraps agy --print, captures the run, and writes a structured result.json so the orchestrator's job collapses to "run one command, read one file." result.json fields include status (completed/failed/timeout/aborted/agy_unavailable), finalMessage (Antigravity's own report), touchedFiles (a git status --porcelain list), readOnlyViolation, agyVersion, and paths to the brief/log/stderr capture. It supports --resume-last to continue a prior conversation with just a delta brief, --read-only to run in plan mode with no write/edit paths, --sandbox to enable Antigravity's terminal sandbox, and a --dangerously-skip-permissions flag (off by default, mutually exclusive with --read-only) that auto-approves every tool permission request when a human explicitly accepts that risk. The same loop scales to a sequential multi-task queue - one commit per task, in dependency order, with a shared progress file tracking status, review notes, and anything that needs the human's eyes.

Use it when you want to delegate a bounded coding task to a separate agy implementer and then review its diff yourself, and the user explicitly asked for delegation to this implementer. Do NOT use it when: the task is small enough to just do inline, since delegation overhead isn't worth it; the agy CLI is not installed or not authenticated (install it from Antigravity's CLI docs and run first-launch setup first); or you want to write the code yourself, or only need Antigravity's opinion on code you already wrote - a --read-only dispatch covers review without edits, and a plain review may not need delegation at all.

The input is a brief: because Antigravity runs in its own conversation with no memory of the orchestrator's prior notes or shared context, the brief must contain everything the task needs - the goal, current state, what to change, what to leave untouched, the project's actual gate commands, and an explicit report contract - structured with XML blocks such as <task>, <verification_loop>, <action_safety>, and <structured_output_contract>. A brief is capped at roughly 120 KB because it rides the command line as an agy --print argument; larger context should live in the workspace instead. Dispatch looks like:

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo

The output is result.json, written to an artifact directory that defaults to the system temp dir so the reviewed repo stays clean. Its key fields for review are status, finalMessage, and touchedFiles (the starting point for the diff read); the implementer only ever edits the working tree - it never runs git add or git commit, and the orchestrator commits after gates pass and the diff holds.

Wraps the Google Antigravity CLI (agy) via agy --print / --continue / --conversation, and requires Node.js and git alongside an authenticated agy installation, checked with agy help and agy models before the first run. It reads a project's own AGENTS.md, CLAUDE.md, Makefile, or package.json to discover the real gate commands to put in the brief, and can invoke a separately installed guard-skills package to run relevant guard checks against the diff during review.

Orchestrating coding agents that need to delegate a scoped implementation task to Google Antigravity while keeping review-and-commit authority - designed for and proven on Claude Code, with other orchestrators treated as designed-for but not yet proven. Adapted from the community amElnagdy/delegate-skills repository under the MIT license; this catalog entry is a docs-only import, since the executable scripts/relay.mjs is not bundled here.