Skip to content

feat(agents): offer Antigravity instead of Gemini as an agent - #11417

Merged
aitchiss merged 1 commit into
mainfrom
netliloop/6634/antigravity-agent
Nov 20, 2026
Merged

aitchiss merged 1 commit into
mainfrom
netliloop/6634/antigravity-agent

Conversation

@netlify-coding

Copy link
Copy Markdown
Contributor

Opened by Netliloop run #6634 (general), asked in Slack

Why

Netlify agent runners are moving from the Gemini CLI to Google's Antigravity coding agent. netlify agents:create and netlify create still offer only claude, codex, gemini, so there is no way to pick Antigravity from the CLI: --agent antigravity fails with Invalid agent. Available agents: claude, codex, gemini.

What changed

  • agents:create and create offer Antigravity in place of Gemini, in the interactive picker, the --agent help text and the generated docs (docs/commands/agents.md, docs/commands/create.md, regenerated with npm run --prefix=site build:docs-md:gen).
  • --agent gemini still works as a deprecated alias: it prints › Warning: The "gemini" agent is deprecated, using "antigravity" instead. and sends agent: "antigravity". The mapping lives in one helper, resolveAgentAlias in src/commands/agents/utils.ts, used by both commands. This mirrors bitballoon's server-side remap of gemini to antigravity (netlify/bitballoon#23773).
  • An unknown agent still errors, now listing claude, codex, antigravity.
  • agents:list and agents:show print an older run's stored gemini as is, in lowercase, because there's no longer a Gemini display name.
  • Unchanged on purpose: caller-agent detection (src/utils/agent-detection.ts, src/utils/init/agent-mcp.ts, the telemetry docs in docs/index.md). There gemini means the Gemini CLI running the Netlify CLI, not an agent runner.

How we verified

New integration tests. All five fail on main and pass on this branch:

  • agents-create.test.ts › should send the antigravity agent in the create request: on main it fails with Error: Invalid agent. Available agents: claude, codex, gemini.
  • agents-create.test.ts › should map the deprecated gemini agent to antigravity with a warning
  • agents-create.test.ts › should list the available agents when the agent is invalid (--agent nonsense; anchored to the end of the message, so it also goes red if gemini is added back to the list)
  • create.test.ts › --agent flag › should send the antigravity agent in the agent runner request
  • create.test.ts › --agent flag › should map the deprecated gemini agent to antigravity with a warning

The tests run the built CLI binary against the repo's mock API and assert on the recorded POST /api/v1/agent_runners body.

  • npx vitest run --retry=0 tests/integration/commands/agents/ tests/integration/commands/create/: 57 passed
  • npx vitest run tests/unit/: 987 passed
  • npm run typecheck, eslint on the touched directories, oxfmt --check: clean
  • netlify agents:create --help and netlify create --help show agent type (claude, codex, antigravity)

We also ran the built CLI binary against a standalone local mock API that records every request body (the only mocked seam is the Netlify API):

agents:create with antigravity, gemini, gemini --json and nonsense

agents:create with --agent antigravity, gemini, gemini --json and nonsense (asciinema recording)

All 8 cases send agent: "antigravity" or refuse before any POST
Command Exit Output POST /api/v1/agent_runners body
agents:create "…" --agent antigravity --branch main 0 Agent: Antigravity, no warning {"branch":"main","prompt":"…","agent":"antigravity"}
same, --agent gemini 0 › Warning: The "gemini" agent is deprecated, using "antigravity" instead. same
same, --agent gemini --json 0 stdout parses as JSON (warnings are suppressed under --json, as for every CLI warning) same
same, --agent nonsense 1 › Error: Invalid agent. Available agents: claude, codex, antigravity none sent
create "…" --agent antigravity --no-wait 0 project created, no warning {"prompt":"…","agent":"antigravity","mode":"create"}
same, --agent gemini 0 deprecation warning, then success same
same, --agent nonsense 1 invalid-agent error none, and no project created
interactive agents:create (no --agent, in a pty) 0 picker lists Claude, Codex, Antigravity; no Gemini agent: "antigravity" after picking it

Full output and recorded requests for the create and interactive picker cases: create-and-picker-receipt.txt

What is left to test

  • Unverified against the real API: no run went through a deployed API with --agent antigravity or --agent gemini.
  • Release timing: don't release this until the API accepts antigravity from the CLI. When to release is a maintainer's call. Merging is safe because nothing reaches users until a release. The server-side remap of gemini (netlify/bitballoon#23773) is still open.

Risk

Merge Risk: Low

One narrow path: the agent name the two commands send. It is covered by integration tests against the mock API. If it's wrong, agents:create/create with Antigravity or Gemini fails visibly with an API error, and Claude and Codex are unaffected.

Linear: PAW-820

Accept --agent gemini as a deprecated alias for antigravity.
@netlify-coding
netlify-coding Bot requested review from a team as code owners November 20, 2026 11:45
@coderabbitai

coderabbitai Bot commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

Explain Change →

No actionable comments were generated in the recent review.

Summary

Summary by CodeRabbit

  • New Features
    • Antigravity is now available as an agent option when creating projects or agents.
    • The legacy gemini value is still accepted and now selects Antigravity, with a deprecation warning.
  • Documentation
    • Updated command documentation to list Antigravity among the supported agent types.

Agent options and documentation now list antigravity instead of gemini. Both command paths resolve the deprecated gemini value to antigravity and display a deprecation warning. Integration tests cover direct Antigravity selection, deprecated Gemini input, and unsupported agent output.

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Feature

Suggested reviewers: vaibhavacharya, sean-roberts

Merge Risk: Low · up to 67f53

This PR offers Antigravity as an agent choice and maps the deprecated gemini value to it with a warning. The CLI side looks sound. Before releasing, confirm that the deployed API accepts antigravity, since the server-side change is still open. Without that, both Antigravity selection and the gemini alias would be rejected.

Pre-merge checks: Passed 4

Check name Status Explanation
Title check Passed The title names the main change: Antigravity is offered in place of Gemini as an agent for the agents:create and create commands. The changeset matches this. It replaces the gemini option with antigra…
Description check Passed The description states the purpose, the changes, the deprecated gemini alias, the unchanged caller-agent detection, the tests, and the release timing. It matches the changeset closely.
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Full details: Title check

Explanation

The title names the main change: Antigravity is offered in place of Gemini as an agent for the agents:create and create commands. The changeset matches this. It replaces the gemini option with antigravity in constants, help text, the interactive picker, and docs, and adds a deprecated gemini alias through resolveAgentAlias.

Finishing Touches

Generate unit tests (beta)

  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Warning

Linked repositories: This review skipped 1 repository. Cross-repository analysis may be incomplete. Check linked repository access and settings.

Recent review info

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Team
  • Run ID: c68b260c-955b-4161-b852-edb55dceeda3
Commits

Reviewing files that changed from the base of the PR and between b095d3d and 67f5324.

Files selected for processing: 10

  • docs/commands/agents.md
  • docs/commands/create.md
  • src/commands/agents/agents-create.ts
  • src/commands/agents/agents.ts
  • src/commands/agents/constants.ts
  • src/commands/agents/utils.ts
  • src/commands/create/create-action.ts
  • src/commands/create/create.ts
  • tests/integration/commands/agents/agents-create.test.ts
  • tests/integration/commands/create/create.test.ts
Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 3 remain after this review.

@github-actions

Copy link
Copy Markdown

📊 Benchmark results

Comparing with b095d3d

  • Dependency count: 968 (no change)
  • Package size: 363 MB (no change)
  • Number of ts-expect-error directives: 281 (no change)

@pkg-pr-new

pkg-pr-new Bot commented Nov 20, 2026

Copy link
Copy Markdown

Open in StackBlitz

npm i https://pkg.pr.new/netlify-cli@11417

commit: 67f5324

@netlify-coding

Copy link
Copy Markdown
Contributor Author

@autobump-app approve

@aitchiss
aitchiss merged commit 638123c into main Nov 20, 2026
37 checks passed
@aitchiss
aitchiss deleted the netliloop/6634/antigravity-agent branch November 20, 2026 14:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants