/agy-delegate

name: agy-delegate
description: Use when doing web searches, looking up current or latest info, researching online, or delegating analysis/review tasks to agy (Google Antigravity CLI). Prefer the WebSearch tool for general web search; use agy for grounded source-cited, current, or second-opinion queries. Triggers on: agy, antigravity, search for, look up, find online, current info, latest, news, research, second opinion from Gemini.

AGY Delegate

agy (Google Antigravity CLI) provides grounded web search with source citations plus access to Gemini — all from one subprocess call. For general web search prefer the `WebSearch` tool; reach for agy when you need real source URLs / a second model / info past Claude's cutoff.

⚠️ Security: Do not pipe content containing credentials, API keys, or PII.

When to Use

**Web search — use agy for grounded/cited results (general search: prefer `WebSearch`):**

• "What is the current...", "latest version of...", "search for..."
• Factual claims that need source citations
• Pricing, changelogs, release notes, documentation

**On request:**

• Adversarial review of code or plans from an independent model (`--type review`)
• Large-file analysis via Gemini's extended context (`--type analysis`)
• "Use agy to...", "Ask Gemini..."

Usage

Bridge: `agy-bridge` (symlink in `~/.local/bin/` — run `/agy-setup` once after plugin install). Wraps `agy` with shell-safe prompt delivery (embedded in a 0600 per-run GEMINI.md — off argv/ps), type routing, and consistent exit-code handling. Set `AGY_SKIP_PERMISSIONS=1` to pass `--dangerously-skip-permissions` when required.

Web search

echo "Claude API pricing June 2026" | agy-bridge --type search

Code / task delegation

agy is sandbox-confined — it runs in an ephemeral workdir and by default cannot read the repo. Pass `--add-dir PATH` (repeatable) to grant access to specific directories; `--sandbox` stays on unconditionally as the API-level floor bounding every read/write to the granted dirs. Read-only, no-shell-exec is enforced only by the per-type `GEMINI.md` policy — prompt-advisory, model-honored, not API-enforced — and under `--type implement` a granted dir is a permitted write target. `PATH` is validated at parse time (must exist as a directory) and resolved to an absolute path before agy runs — an invalid path exits 2 immediately, before any call is made. Grant the narrowest directory that covers what agy needs — `--add-dir` exposes everything under that path, not just the file(s) you care about. `/` and `$HOME` (exact match, resolved) are refused with exit 2 unless `AGY_ALLOW_BROAD_GRANT=1` is set; this is a speed bump on the two broadest accidental grants, not a containment boundary — a subdirectory like `$HOME/sub` is still granted normally.

echo "$QUESTION" | agy-bridge --type code --add-dir ./src

If you can't or don't want to grant a directory, inline the needed file content into the piped prompt instead:

echo "$QUESTION" | agy-bridge --type code

Adversarial review

echo "$TASK" | agy-bridge --type review

Inline prompt (no stdin)

agy-bridge --type search -- "latest dplyr release"

JSON output envelope

echo "query" | agy-bridge --type search --json
# → {"success":true,"model_used":"...","type":"search","duration_seconds":9,"response":"..."}

Model Routing

| `--type` | Auto-selected model | Why | |----------|--------------------|----| | `search` | gemini-*-flash-high (latest) | Fast, web-grounded | | `code` | gemini-*-pro-high (latest) | Extended context | | `analysis` | gemini-*-pro-high (latest) | Large file analysis | | `review` | gemini-*-pro-high (latest) | Second-pass critique, adversarial prompt framing | | `implement` | gemini-*-pro-high (latest) | File read+write, no shell exec — use when agy must write output files |

Omitting `--type` defaults to `code`. Override with `--model MODEL_ID` — run `agy models` for current CLI ids.

Run `agy models` for current model names — values above match bridge defaults and may lag agy updates.

Common Mistakes

| Symptom | Fix | |---------|-----| | Response lacks source URLs | Re-run with `--type search` (prefix prompts agy to call `search_web`) | | Exit 124 | Timeout — simplify query or pass `--timeout 600` | | Model name rejected | Exact string required — run `agy models` for current names | | `agy: command not found` | Binary at `~/.local/bin/agy` — check PATH | | `agy-bridge: command not found` | Symlink not created — run `/agy-setup` once. Do NOT silently fall back. Stop, state the bridge is unavailable and that proceeding natively (WebSearch for search, native tools for code/review) burns the calling agent's own quota, and ask for explicit confirmation before proceeding; decline → report blocked; confirm → proceed natively exactly as today. | | Calling `agy` directly | Use bridge — direct calls miss type routing and exit-code normalization | | Empty response / hidden failure (exit 3) | Quota or auth — check error_class (quota=429/RESOURCE_EXHAUSTED → retry later; auth=UNAUTHENTICATED → re-auth agy; else empty_output → inspect stderr) | | Reaching for agy on a simple web search | Prefer the WebSearch tool (cc-websearch when installed); use agy --type search only for grounded/cited results or a second model |

Writing effective agy prompts

Print mode is one-shot — agy can't ask a clarifying question, so the prompt is the whole brief. For how to write one (data-first, negative-constraints-last, the 5-part brief), see the [`gemini-3-prompting`](../gemini-3-prompting/SKILL.md) skill.

Reference

Provider details, auth, timeout guidance: `config/provider.md`