Gemini CLI → Antigravity CLI Migration
Google is retiring Gemini CLI on June 18, 2026. On that date, Gemini CLI and the Gemini Code Assist IDE extensions stop serving requests for Google AI Pro/Ultra and free Gemini Code Assist for individuals. Enterprise plans (Gemini Code Assist Standard/Enterprise, and GCA for GitHub via Google Cloud) are unaffected.
The successor is the Antigravity CLI (agy), the Go-based CLI that shipped with Antigravity 2.0 at Google I/O 2026. It carries over the most critical features of Gemini CLI — Agent Skills, Hooks, MCP, and rules/context files — though Google has stated there is no 1:1 feature parity right out of the gate.
This guide explains how to move a rulesync configuration from the geminicli target to the new antigravity-cli target.
geminicli is not removed
Rulesync keeps the geminicli target:
- Enterprise access to Gemini CLI continues past June 18, 2026.
- Countless existing
GEMINI.md/.gemini/repositories still depend on it.
geminicli is simply marked deprecated in the supported tools matrix. New projects should prefer antigravity-cli; existing projects can keep generating both during a transition.
Feature mapping
| Feature | geminicli | antigravity-cli |
|---|---|---|
| rules | root GEMINI.md + .gemini/memories/ | root GEMINI.md + .agents/rules/; global ~/.gemini/GEMINI.md |
| skills | .gemini/skills/ | .agents/skills/; global ~/.gemini/antigravity-cli/skills/ |
| mcp | .gemini/settings.json (mcpServers) | .agents/mcp_config.json; global ~/.gemini/antigravity-cli/mcp_config.json |
| hooks | .gemini/ (Gemini hook shape) | .agents/hooks.json; global ~/.gemini/config/hooks.json (Claude-Code-like matcher shape) |
| permissions | .gemini/settings.json | global ~/.gemini/antigravity-cli/settings.json (permissions.allow/ask/deny) |
| commands | .gemini/commands/ (TOML) | not yet supported — Antigravity CLI exposes slash commands via skills |
| subagents | .gemini/agents/ | not yet supported — CLI subagents are only definable via plugin bundles |
Notable differences
- MCP: Antigravity uses
serverUrl(noturl) for HTTP servers and honors adisabledToolsarray. Rulesync emits the Antigravity-compatible shape automatically. - Hooks: Antigravity uses a Claude-Code-like
hooks.jsonwith a matcher shape, not the Gemini CLI hook format. Rulesync currently translates thepreToolUse,postToolUse, andstopevents for Antigravity. - Permissions: The Antigravity CLI reads permissions only from the global
~/.gemini/antigravity-cli/settings.json; there is no documented workspace-scoped permissions file, so rulesync generates this file in global mode only. The canonicalbashtool maps to Antigravity'scommandtool name. - Commands / subagents: These are intentionally out of scope for
antigravity-clitoday. Antigravity surfaces slash commands through skills. CLI subagents are defined and managed at runtime (the interactive/agentspanel and the orchestrator'sinvoke_subagent/define_subagenttools), and the only file-based way to ship one is bundled inside a plugin (a namespaced package of skills + subagents + rules + MCP + hooks). There is no standalone, declarative per-agent file (analogous togeminicli's.gemini/agents/) that rulesync could generate, and the plugin bundle does not map cleanly onto rulesync's per-feature model. Keep generating subagents withgeminicliif you still rely on them.
Updating rulesync.jsonc
Replace the geminicli target with antigravity-cli. For example:
{
"targets": {
// Before
// "geminicli": { "rules": true, "skills": true, "mcp": true, "hooks": true, "permissions": true },
// After
"antigravity-cli": {
"rules": true,
"skills": true,
"mcp": true,
"hooks": true,
"permissions": true,
},
},
}To generate global-scope files (including the permissions file, which is global-only), run with --global:
rulesync generate --targets antigravity-cli --globalYou can keep both targets enabled during a transition so the same .rulesync/ sources fan out to both .gemini/ (Gemini CLI) and .agents/ (Antigravity CLI) trees.
See also
- Supported Tools and Features
- Global Mode
- Google's official migration guide: https://antigravity.google/docs/gcli-migration
- Announcement: https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
