delegate
Delegate a well-scoped subtask to Antigravity (agy/Gemini) under cost discipline, then verify.
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/yuting0624/antigravity-for-claude-code/HEAD/commands/delegate.md -o ~/.claude/commands/delegate.mddelegate.md
Delegate the following task to Antigravity (`agy` / Gemini) via the plugin wrapper, following the `antigravity` skill's **Cost discipline** and **Verification gates**. Task: $ARGUMENTS Do this: 1. Pick a tier (`flash` default; `pro` for hard reasoning). If the task needs the repo, add `--dir <repo-root>` so agy reads the real files (don't paste them into context). **If the task WRITES files or uses tools** (web / Vertex AI Search / terminal), it needs a grant. For a plain file write the narrower one is a `write_file(<dir>)` entry under `permissions.allow` in `~/.gemini/antigravity-cli/settings.json` (recursive beneath `<dir>`, no flag needed — substitute a real path for `<dir>`; if a rule is already there and the write is still denied, `agy-doctor` checks whether agy can parse it). Otherwise pass **`--yolo`**, which auto-approves all tools and is what web / Vertex AI Search / terminal need. Without a grant, headless agy leaves your workspace untouched, and only the newest versions admit it (it describes / scratch-diverts / soft-denies / fails outright depending on version; issue #10). `--mode accept-edits` is not a grant either: measured on agy 1.1.13, where the flag is applied at all, the write is denied exactly like one without it. Run write tasks on a dedicated branch — `--sandbox` is not containment, it was measured doing nothing under `--yolo` — and **verify files actually changed** with `git status`. Claude Code may prompt for or block `--dangerously-skip-permissions` — approve it or pre-allow it; non-interactive (`claude -p`) without that permission can't write/use-tools via agy. (If the wrapper returns exit `15`, that's exactly this: agy denied the write. Both shapes land here — the soft deny on agy 1.1.3 and the hard error on 1.1.13 — and both take the same fix: a `permissions.allow` rule covering the target, or `--yolo`.) 2. Run **synchronously** (you may be headless — do not background-and-wait): `agy-delegate --tier <tier> [--dir .] [--yolo] [--digest] "<task>"` For read/analysis tasks, add `--digest` — it appends a digest-only output contract so agy returns compact bullets instead of raw content. 3. Ingest only the **result/digest** — do NOT re-read the files agy already handled (keeps your context lean; that's where the cost savings come from). If the wrapper prints a *"looks like a raw dump"* note on stderr, do NOT ingest the raw output — re-run with `--digest` or ask agy to summarize it first. 4. **Verify**: actually run/check the output; never trust a self-reported "done". Report what you delegated and how you verified it. Remember the break-even: only delegate if the offloaded volume clearly exceeds the spec + round-trip + verification overhead. Tiny tasks are cheaper to just do yourself. **Long task, interactive session?** A sync delegation can also hit Claude Code's ~2-min Bash-tool limit — start it in the background and keep working (this also keeps the prompt cache warm and frees you to do other turns): `ID=$(agy-job start --tier pro --dir . "<task>")` then check `/antigravity:status` and collect with `/antigravity:result <id>`. (Don't do this when YOU are headless `claude -p` — one-shot, no later turn to collect; delegate synchronously there.)
Run the Antigravity CLI (Gemini) as a collaborating AI inside Claude Code, with intelligent model routing across the software development lifecycle. Claude is the conductor/orchestrator — requirements, architecture, the hard 20%, verification, and review — and routes deterministic, high-volume work (scaffolding, boilerplate, test generation, first-pass review, migrations, web/Vertex AI Search) to Antigravity (Gemini), the cheaper, faster model. Use when the user wants to "use Antigravity / agy", "vibe code / agentic engineering", "accelerate the SDLC", "delegate to Gemini", "scaffold / generate tests / migrate", "first-pass code review", "search web or internal/company data", "deep research / multi-source research report", "second-model cross-check", or "lower token cost on a big job". Claude always verifies Antigravity's output and re-checks itself if unsatisfied.
|
Cancel a running background Antigravity (agy) delegation job.
Diagnose a failing Cloud Run service — Antigravity (agy/Gemini) digests the error logs cheaply, Claude infers the root cause and proposes a fix. Read-only by default; --apply writes the fix to a branch.
Understand an audio / video / image file — Antigravity (agy/Gemini) transcribes and analyzes it, returning a timestamped digest while the full transcript goes to a file.
Migrate an existing Claude Code setup (skills, memory, CLAUDE.md, MCP, plugins, permissions) to the Antigravity CLI.
Move an existing Claude Code setup onto the Antigravity CLI (agy) — user skills, CLAUDE.md, auto-memory, MCP servers, installed plugins, permissions and trusted workspaces. Use when the user says "migrate to Antigravity", "move my Claude Code config to agy", "bring my skills/memory/MCP over", "set up agy like my Claude Code", "agy plugin import claude found nothing", or asks what can and cannot be carried across. Also use to explain the two config layouts, or to reverse a migration.
Claude-orchestrated deep research — Antigravity (agy/Gemini) does the grounded web legwork; Claude plans, verifies the citations, and synthesizes.