feat: add agy (Antigravity CLI) as a supported --cli provider

Mike · claude · Mike · commit 1433c52a2b75 · 2026-05-31T17:45:57.000+02:00
Adds agy alongside claude, gemini, codex, agent, openclaw, opencode,
and copilot. Uses a plain-text path (--print + stdin) since agy does
not support --output-format json. Default model is null — agy uses its
own session default (Gemini 3.5 Flash) when no model is specified.
Binary resolved via AGY_PATH env var or agy on PATH.

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/README.md b/README.md
@@ -331,7 +331,7 @@ Use `summarize --help` or `summarize help` for the full help text.
 - `--length short|medium|long|xl|xxl|s|m|l|<chars>`
 - `--language, --lang <language>`: output language (`auto` = match source)
 - `--max-output-tokens <count>`: hard cap for LLM output tokens
-- `--cli [provider]`: use a CLI provider (`--model cli/<provider>`). Supports `claude`, `gemini`, `codex`, `agent`, `openclaw`, `opencode`. If omitted, uses auto selection with CLI enabled.
+- `--cli [provider]`: use a CLI provider (`--model cli/<provider>`). Supports `claude`, `gemini`, `codex`, `agent`, `openclaw`, `opencode`, `agy`. If omitted, uses auto selection with CLI enabled.
 - `--stream auto|on|off`: stream LLM output (`auto` = TTY only; disabled in `--json` mode)
 - `--plain`: keep raw output (no ANSI/OSC Markdown rendering)
 - `--no-color`: disable ANSI colors
@@ -353,7 +353,7 @@ Use `summarize --help` or `summarize help` for the full help text.
 - `--verbose`: debug/diagnostics on stderr
 - `--metrics off|on|detailed`: metrics output (default `on`)
 
-### Coding CLIs (Codex, Claude, Gemini, Agent, OpenClaw, OpenCode)
+### Coding CLIs (Codex, Claude, Gemini, Agent, OpenClaw, OpenCode, Antigravity)
 
 Summarize can use common coding CLIs as local model backends:
 
@@ -363,15 +363,16 @@ Summarize can use common coding CLIs as local model backends:
 - `agent` (Cursor Agent CLI) -> `--cli agent` / `--model cli/agent/<model>`
 - `openclaw` -> `--cli openclaw` / `--model cli/openclaw/<model>` or `--model openclaw/<model>`
 - `opencode` -> `--cli opencode` / `--model cli/opencode/<model>` (`--model cli/opencode` uses the OpenCode runtime default)
+- `agy` (Antigravity CLI) -> `--cli agy` / `--model cli/agy/<model>` (uses agy's active session model when no model is specified)
 
 Built-in preset:
 
 - `--model codex-fast` runs Codex with GPT-5.5 Fast mode and requires `codex login`.
 
 Requirements:
 
-- Binary installed and on `PATH` (or set `CODEX_PATH`, `CLAUDE_PATH`, `GEMINI_PATH`, `AGENT_PATH`, `OPENCLAW_PATH`, `OPENCODE_PATH`)
-- Provider authenticated (`codex login`, `claude auth`, `gemini` login flow, `agent login` or `CURSOR_API_KEY`, `opencode auth login`)
+- Binary installed and on `PATH` (or set `CODEX_PATH`, `CLAUDE_PATH`, `GEMINI_PATH`, `AGENT_PATH`, `OPENCLAW_PATH`, `OPENCODE_PATH`, `AGY_PATH`)
+- Provider authenticated (`codex login`, `claude auth`, `gemini` login flow, `agent login` or `CURSOR_API_KEY`, `opencode auth login`, `agy` login flow or `ANTIGRAVITY_API_KEY`)
 
 Quick smoke test:
 
@@ -384,13 +385,14 @@ summarize --cli gemini --plain --timeout 2m /tmp/summarize-cli-smoke.txt
 summarize --cli agent --plain --timeout 2m /tmp/summarize-cli-smoke.txt
 summarize --cli openclaw --plain --timeout 2m /tmp/summarize-cli-smoke.txt
 summarize --cli opencode --plain --timeout 2m /tmp/summarize-cli-smoke.txt
+summarize --cli agy --plain --timeout 2m /tmp/summarize-cli-smoke.txt
 ```
 
 Set explicit CLI allowlist/order:
 
 ```json
 {
-  "cli": { "enabled": ["codex", "claude", "gemini", "agent", "openclaw", "opencode"] }
+  "cli": { "enabled": ["codex", "claude", "gemini", "agent", "openclaw", "opencode", "agy"] }
 }
 ```
 
@@ -402,7 +404,7 @@ Configure implicit auto CLI fallback:
     "autoFallback": {
       "enabled": true,
       "onlyWhenNoApiKeys": true,
-      "order": ["claude", "gemini", "codex", "agent", "openclaw", "opencode"]
+      "order": ["claude", "gemini", "codex", "agent", "openclaw", "opencode", "agy"]
     }
   }
 }
diff --git a/apps/chrome-extension/src/lib/settings.ts b/apps/chrome-extension/src/lib/settings.ts
@@ -151,7 +151,8 @@ function normalizeAutoCliOrder(value: unknown): string {
       item !== "agent" &&
       item !== "openclaw" &&
       item !== "opencode" &&
-      item !== "copilot"
+      item !== "copilot" &&
+      item !== "agy"
     ) {
       continue;
     }
@@ -311,7 +312,7 @@ export const defaultSettings: Settings = {
   summaryTimestamps: true,
   extendedLogging: false,
   autoCliFallback: true,
-  autoCliOrder: "claude,gemini,codex,agent,openclaw,opencode,copilot",
+  autoCliOrder: "claude,gemini,codex,agent,openclaw,opencode,copilot,agy",
   hoverPrompt:
     "Plain text only (no Markdown). Summarize the linked page concisely in 1-2 sentences; aim for 100-200 characters.",
   transcriber: "",
diff --git a/src/config/parse-helpers.ts b/src/config/parse-helpers.ts
@@ -17,7 +17,8 @@ export function parseCliProvider(value: unknown, path: string): CliProvider {
     trimmed === "agent" ||
     trimmed === "openclaw" ||
     trimmed === "opencode" ||
-    trimmed === "copilot"
+    trimmed === "copilot" ||
+    trimmed === "agy"
   ) {
     return trimmed as CliProvider;
   }
diff --git a/src/config/sections.ts b/src/config/sections.ts
@@ -325,6 +325,7 @@ export function parseCliConfig(root: Record<string, unknown>, path: string): Cli
   const copilot = value.copilot
     ? parseCliProviderConfig(value.copilot, path, "copilot")
     : undefined;
+  const agy = value.agy ? parseCliProviderConfig(value.agy, path, "agy") : undefined;
   if (typeof value.autoFallback !== "undefined" && typeof value.magicAuto !== "undefined") {
     throw new Error(
       `Invalid config file ${path}: use only one of "cli.autoFallback" or legacy "cli.magicAuto".`,
@@ -359,6 +360,7 @@ export function parseCliConfig(root: Record<string, unknown>, path: string): Cli
     openclaw ||
     opencode ||
     copilot ||
+    agy ||
     autoFallback ||
     promptOverride ||
     typeof allowTools === "boolean" ||
@@ -373,6 +375,7 @@ export function parseCliConfig(root: Record<string, unknown>, path: string): Cli
         ...(openclaw ? { openclaw } : {}),
         ...(opencode ? { opencode } : {}),
         ...(copilot ? { copilot } : {}),
+        ...(agy ? { agy } : {}),
         ...(autoFallback ? { autoFallback } : {}),
         ...(promptOverride ? { promptOverride } : {}),
         ...(typeof allowTools === "boolean" ? { allowTools } : {}),
diff --git a/src/config/types.ts b/src/config/types.ts
@@ -7,7 +7,8 @@ export type CliProvider =
   | "agent"
   | "openclaw"
   | "opencode"
-  | "copilot";
+  | "copilot"
+  | "agy";
 export type OpenAiReasoningEffort = "none" | "low" | "medium" | "high" | "xhigh";
 export type OpenAiTextVerbosity = "low" | "medium" | "high";
 export type ModelRequestOptions = {
@@ -36,6 +37,7 @@ export type CliConfig = {
   openclaw?: CliProviderConfig;
   opencode?: CliProviderConfig;
   copilot?: CliProviderConfig;
+  agy?: CliProviderConfig;
   autoFallback?: CliAutoFallbackConfig;
   magicAuto?: CliAutoFallbackConfig;
   promptOverride?: string;
diff --git a/src/daemon/env-snapshot.ts b/src/daemon/env-snapshot.ts
@@ -41,6 +41,7 @@ const ENV_KEYS = [
   "OPENCLAW_PATH",
   "OPENCODE_PATH",
   "COPILOT_PATH",
+  "AGY_PATH",
   "UVX_PATH",
 ] as const;
 
diff --git a/src/daemon/models.ts b/src/daemon/models.ts
@@ -142,6 +142,7 @@ export async function buildModelPickerOptions({
     cliOpenclaw: boolean;
     cliOpencode: boolean;
     cliCopilot: boolean;
+    cliAgy: boolean;
   };
   openaiBaseUrl: string | null;
   localModelsSource: { kind: "openai-compatible"; baseUrlHost: string } | null;
@@ -164,6 +165,7 @@ export async function buildModelPickerOptions({
     cliOpenclaw: false,
     cliOpencode: false,
     cliCopilot: false,
+    cliAgy: false,
   };
   const cliAvailability = resolveCliAvailability({ env: envForRun, config: configForCli });
   providers.cliClaude = Boolean(cliAvailability.claude);
@@ -173,6 +175,7 @@ export async function buildModelPickerOptions({
   providers.cliOpenclaw = Boolean(cliAvailability.openclaw);
   providers.cliOpencode = Boolean(cliAvailability.opencode);
   providers.cliCopilot = Boolean(cliAvailability.copilot);
+  providers.cliAgy = Boolean(cliAvailability.agy);
 
   const options: ModelPickerOption[] = [
     { id: "auto", label: "Auto" },
@@ -201,6 +204,9 @@ export async function buildModelPickerOptions({
   if (providers.cliCopilot) {
     options.push({ id: "cli/copilot", label: "CLI: GitHub Copilot" });
   }
+  if (providers.cliAgy) {
+    options.push({ id: "cli/agy", label: "CLI: Antigravity (agy)" });
+  }
 
   if (providers.openrouter) {
     options.push({ id: "free", label: "Free (OpenRouter)" });
diff --git a/src/llm/cli-provider-output.ts b/src/llm/cli-provider-output.ts
@@ -1,7 +1,7 @@
 import type { CliProvider } from "../config.js";
 import type { LlmTokenUsage } from "./generate-text.js";
 
-export type JsonCliProvider = Exclude<CliProvider, "codex" | "openclaw" | "opencode" | "copilot">;
+export type JsonCliProvider = Exclude<CliProvider, "codex" | "openclaw" | "opencode" | "copilot" | "agy">;
 
 const JSON_RESULT_FIELDS = ["result", "response", "output", "message", "text"] as const;
 
@@ -10,7 +10,8 @@ export function isJsonCliProvider(provider: CliProvider): provider is JsonCliPro
     provider !== "codex" &&
     provider !== "openclaw" &&
     provider !== "opencode" &&
-    provider !== "copilot"
+    provider !== "copilot" &&
+    provider !== "agy"
   );
 }
 
diff --git a/src/llm/cli.ts b/src/llm/cli.ts
@@ -23,6 +23,7 @@ const DEFAULT_BINARIES: Record<CliProvider, string> = {
   openclaw: "openclaw",
   opencode: "opencode",
   copilot: "copilot",
+  agy: "agy",
 };
 
 const OPENCLAW_MAX_MESSAGE_ARG_BYTES = 120 * 1024;
@@ -37,6 +38,7 @@ const PROVIDER_PATH_ENV: Record<CliProvider, string> = {
   openclaw: "OPENCLAW_PATH",
   opencode: "OPENCODE_PATH",
   copilot: "COPILOT_PATH",
+  agy: "AGY_PATH",
 };
 
 type RunCliModelOptions = {
@@ -72,6 +74,7 @@ function getCliProviderConfig(
   if (provider === "agent") return config.agent;
   if (provider === "openclaw") return config.openclaw;
   if (provider === "opencode") return config.opencode;
+  if (provider === "agy") return config.agy;
   return config.copilot;
 }
 
@@ -371,6 +374,28 @@ export async function runCliModel({
     return { text, usage: null, costUsd: null };
   }
 
+  if (provider === "agy") {
+    const agyArgs: string[] = [...providerExtraArgs, "--print"];
+    if (requestedModel) {
+      agyArgs.push("--model", requestedModel);
+    }
+    if (allowTools) {
+      agyArgs.push("--dangerously-skip-permissions");
+    }
+    const { stdout } = await execCliWithInput({
+      execFileImpl: execFileFn,
+      cmd: binary,
+      args: agyArgs,
+      input: prompt,
+      timeoutMs,
+      env: effectiveEnv,
+      cwd,
+    });
+    const text = stdout.trim();
+    if (!text) throw new Error("CLI returned empty output");
+    return { text, usage: null, costUsd: null };
+  }
+
   if (!isJsonCliProvider(provider)) {
     throw new Error(`Unsupported CLI provider "${provider}".`);
   }
diff --git a/src/llm/provider-profile.ts b/src/llm/provider-profile.ts
@@ -35,7 +35,8 @@ export type RequiredModelEnv =
   | "CLI_AGENT"
   | "CLI_OPENCLAW"
   | "CLI_OPENCODE"
-  | "CLI_COPILOT";
+  | "CLI_COPILOT"
+  | "CLI_AGY";
 
 type GatewayProviderProfile = {
   requiredEnv: RequiredModelEnv;
@@ -105,6 +106,7 @@ export const DEFAULT_CLI_MODELS: Record<CliProvider, string | null> = {
   openclaw: "main",
   opencode: null,
   copilot: null,
+  agy: null,
 };
 
 export const DEFAULT_AUTO_CLI_ORDER: CliProvider[] = [
@@ -115,6 +117,10 @@ export const DEFAULT_AUTO_CLI_ORDER: CliProvider[] = [
   "openclaw",
   "opencode",
   "copilot",
+  // agy (Antigravity CLI) included in auto-fallback: it uses the same
+  // plain-text --print interface as copilot and falls back gracefully
+  // when not installed (binary availability check via AGY_PATH / PATH).
+  "agy",
 ];
 
 export function parseCliProviderName(raw: string): CliProvider | null {
@@ -126,6 +132,7 @@ export function parseCliProviderName(raw: string): CliProvider | null {
   if (normalized === "openclaw") return "openclaw";
   if (normalized === "opencode") return "opencode";
   if (normalized === "copilot") return "copilot";
+  if (normalized === "agy") return "agy";
   return null;
 }
 
@@ -142,7 +149,9 @@ export function requiredEnvForCliProvider(provider: CliProvider): RequiredModelE
             ? "CLI_OPENCODE"
             : provider === "copilot"
               ? "CLI_COPILOT"
-              : "CLI_CLAUDE";
+              : provider === "agy"
+                ? "CLI_AGY"
+                : "CLI_CLAUDE";
 }
 
 export function getGatewayProviderProfile(provider: GatewayProvider): GatewayProviderProfile {
diff --git a/src/model-auto-cli.ts b/src/model-auto-cli.ts
@@ -114,7 +114,9 @@ export function prependCliCandidates({
                 ? cli?.opencode?.model
                 : provider === "copilot"
                   ? cli?.copilot?.model
-                  : cli?.claude?.model;
+                  : provider === "agy"
+                    ? cli?.agy?.model
+                    : cli?.claude?.model;
     add(provider, modelOverride);
   }
 
diff --git a/src/model-spec.ts b/src/model-spec.ts
@@ -54,7 +54,8 @@ export type FixedModelSpec =
         | "CLI_AGENT"
         | "CLI_OPENCLAW"
         | "CLI_OPENCODE"
-        | "CLI_COPILOT";
+        | "CLI_COPILOT"
+        | "CLI_AGY";
       cliProvider: CliProvider;
       cliModel: string | null;
     };
@@ -191,7 +192,8 @@ export function parseRequestedModelId(raw: string): RequestedModel {
       providerRaw !== "agent" &&
       providerRaw !== "openclaw" &&
       providerRaw !== "opencode" &&
-      providerRaw !== "copilot"
+      providerRaw !== "copilot" &&
+      providerRaw !== "agy"
     ) {
       throw new Error(`Invalid CLI model id "${trimmed}". Expected cli/<provider>/<model>.`);
     }
@@ -207,6 +209,7 @@ export function parseRequestedModelId(raw: string): RequestedModel {
       | "CLI_OPENCLAW"
       | "CLI_OPENCODE"
       | "CLI_COPILOT"
+      | "CLI_AGY"
     >;
     const userModelId = cliModel ? `cli/${cliProvider}/${cliModel}` : `cli/${cliProvider}`;
     return {
diff --git a/src/run/cli-fallback-state.ts b/src/run/cli-fallback-state.ts
@@ -18,7 +18,8 @@ function parseCliProvider(value: unknown): CliProvider | null {
     value === "agent" ||
     value === "openclaw" ||
     value === "opencode" ||
-    value === "copilot"
+    value === "copilot" ||
+    value === "agy"
   ) {
     return value;
   }
diff --git a/src/run/env.ts b/src/run/env.ts
@@ -84,6 +84,7 @@ export function resolveCliAvailability({
     "openclaw",
     "opencode",
     "copilot",
+    "agy",
   ];
   const availability: Partial<Record<CliProvider, boolean>> = {};
   for (const provider of providers) {
@@ -113,7 +114,8 @@ export function parseCliUserModelId(modelId: string): {
     provider !== "agent" &&
     provider !== "openclaw" &&
     provider !== "opencode" &&
-    provider !== "copilot"
+    provider !== "copilot" &&
+    provider !== "agy"
   ) {
     throw new Error(`Invalid CLI model id "${modelId}". Expected cli/<provider>/<model>.`);
   }
@@ -130,7 +132,8 @@ export function parseCliProviderArg(raw: string): CliProvider {
     normalized === "agent" ||
     normalized === "openclaw" ||
     normalized === "opencode" ||
-    normalized === "copilot"
+    normalized === "copilot" ||
+    normalized === "agy"
   ) {
     return normalized as CliProvider;
   }
diff --git a/src/run/help.ts b/src/run/help.ts
@@ -141,7 +141,7 @@ export function buildProgram() {
     .addOption(
       new Option(
         "--cli [provider]",
-        "Use a CLI provider: claude, gemini, codex, agent, openclaw, opencode, copilot (equivalent to --model cli/<provider>). If omitted, use auto selection with CLI enabled.",
+        "Use a CLI provider: claude, gemini, codex, agent, openclaw, opencode, copilot, agy (equivalent to --model cli/<provider>). If omitted, use auto selection with CLI enabled.",
       ),
     )
     .option("--extract", "Print extracted content and exit (no LLM summary)", false)
@@ -295,6 +295,7 @@ ${heading("Env Vars")}
   OPENCLAW_PATH         optional (path to OpenClaw CLI binary)
   OPENCODE_PATH         optional (path to OpenCode CLI binary)
   COPILOT_PATH          optional (path to GitHub Copilot CLI binary)
+  AGY_PATH              optional (path to Antigravity CLI binary)
   SUMMARIZE_MODEL       optional (overrides default model selection)
   SUMMARIZE_THEME       optional (${CLI_THEME_NAMES.join(", ")})
   SUMMARIZE_TRUECOLOR   optional (force 24-bit color)
diff --git a/src/run/run-config.ts b/src/run/run-config.ts
@@ -61,7 +61,7 @@ export function resolveConfigState({
   const cliEnabledOverride: CliProvider[] | null = (() => {
     if (!cliFlagPresent || cliProviderArg) return null;
     if (Array.isArray(config?.cli?.enabled)) return config.cli.enabled;
-    return ["claude", "gemini", "codex", "agent", "openclaw", "opencode", "copilot"];
+    return ["claude", "gemini", "codex", "agent", "openclaw", "opencode", "copilot", "agy"];
   })();
   const cliConfigForRun = cliEnabledOverride
     ? { ...(config?.cli ?? {}), enabled: cliEnabledOverride }
diff --git a/src/run/run-models.ts b/src/run/run-models.ts
diff --git a/src/run/run-settings-parse.ts b/src/run/run-settings-parse.ts
diff --git a/src/run/summary-engine.ts b/src/run/summary-engine.ts
diff --git a/src/run/types.ts b/src/run/types.ts
diff --git a/tests/config.test.ts b/tests/config.test.ts
diff --git a/tests/daemon.config.test.ts b/tests/daemon.config.test.ts
diff --git a/tests/llm.cli.agy.test.ts b/tests/llm.cli.agy.test.ts
