feat: Add Antigravity CLI (agy) as a built-in terminal agent

[derekhsu]

Feature Description

Add Antigravity CLI (agy) as a built-in terminal agent with the same level of integration as existing built-in agents (Claude, Codex, OpenCode, etc.).

Motivation

Google Antigravity is Google's official agentic development platform, and the agy CLI is its terminal interface. It offers:

• Multi-step reasoning and autonomous code generation
• Built-in parallel execution and sub-agent orchestration
• Integration with Gemini models (including Gemini 3.5 Flash)
• Project-level context via AGENTS.md rules
• Mature platform with active development

As a widely-used, production-grade CLI agent, adding native support for agy would benefit many developers already using Antigravity.

Expected Integration

1. Wrapper script at ~/.superset/bin/agy (similar to existing claude, codex, opencode wrappers)
2. Notification hook integration for session lifecycle events
3. Preset template in Settings → Agents
4. Builtin agent manifest entry in BUILTIN_TERMINAL_AGENTS
5. Icon and label in agent picker UI

Technical Notes

• agy uses a similar pattern to other CLI agents (interactive TUI + --print / --prompt modes)
• Known issue: agy --print in non-TTY mode currently produces no output (see google-antigravity/antigravity-cli#76). Superset may need to invoke it with a pseudo-TTY or use --dangerously-skip-permissions for headless runs.
• Official docs: https://antigravity.google/docs/cli

Alternatives

Users can currently run agy as a generic CLI agent in any Superset terminal, but they lose:

• Built-in preset templates
• Notification hooks (agent lifecycle events)
• First-class agent picker integration

This feature request is for first-class, built-in support.

[github-actions]

Triage notes

Thanks for the detailed proposal! Triaging this as a feature request (no bug to reproduce), so this is a scoping/triage note rather than a PR.

Where this would be implemented (the integration is well-templated, so the touchpoints are clear):

1. Manifest entry — add an agy entry to BUILTIN_TERMINAL_AGENTS in packages/shared/src/builtin-terminal-agents.ts. This single array drives the id/label/description, the launch command, the promptCommand + promptTransport, and the includeInDefaultTerminalPresets flag. (gemini is the closest existing template, since both target Google models.)
2. Wrapper + notify hook — a wrapper under ~/.superset/bin/ created in apps/desktop/src/main/lib/agent-setup/. Lifecycle notifications are wired per-agent: some agents merge hook definitions into a native config file (Claude → ~/.claude/settings.json, Codex → ~/.codex/hooks.json), others rely purely on the env-forwarding wrapper. Which path agy needs depends on what lifecycle-hook surface its CLI exposes.
3. Icon — add agy.svg (light + dark variants like codex/opencode) under packages/ui/src/assets/icons/preset-icons/ and register it in PRESET_ICONS in that dir's index.ts.
4. Default presets — covered automatically via includeInDefaultTerminalPresets on the manifest entry; default-v2-terminal-presets.ts derives from it.

Blocker before this can ship as a first-class integration:

The issue itself notes that agy --print produces no output in non-TTY mode. Superset's prompt-injection path (promptCommand / promptTransport) relies on launching the agent non-interactively with a prompt, so a working headless prompt mode (stdin or argv) is a prerequisite for first-class support — otherwise the "send a task prompt to the agent" integration would be dead on arrival. The exact command/promptCommand flags and the lifecycle-hook mechanism also need to be confirmed against the real CLI before they're hard-coded into the manifest; this environment can't run or verify the agy binary.

In the meantime: as the issue notes, agy already works as a generic CLI agent in any Superset terminal — you just don't get the preset/icon/hook integration.

Suggested next step: confirm agy's headless prompt invocation (and lifecycle-hook config surface, if any), and then the manifest + icon + wrapper additions above are a small, mechanical change.

[antongulin]

+1 for Antigravity CLI. Superset has Gemini and Google released updates to force to use Antigravity.

[antongulin]

@derekhsu It works for me adding custom preset

[farmdawgnation]

I'm taking a stab at this.

[yanjinbin]

what's going on? when we can see antigravity agent is preset ? which version?