Antigravity CLI
A Gemini-based harness with skills, agents, plugins, hooks, MCP, and project resources
- antigravity
- harness
- setup

Antigravity CLI is a Gemini-based harness for agentic development. Its distinctive property is that configuration lives in Gemini's shared home: Antigravity-owned settings and plugins live under antigravity-cli, while skills and agents use the shared config surface. A project has its own .agents/ surface.
Native surface
| Area | What Antigravity CLI reads | ai-stp projection |
|---|---|---|
| Shared Gemini home | ~/.gemini/config/skills/, agents/, plugins/, hooks.json, mcp_config.json, global_workflows/ | Global skill, agent, plugin, hook, MCP, and command |
| CLI-owned area | ~/.gemini/antigravity-cli/settings.json, keybindings.json, plugins/ | Setting and CLI plugin surface |
| Project | .agents/plugins/, .agents/skills/, .agents/agents/, .agents/hooks.json, .agents/mcp_config.json | Project-scoped resources |
Do not copy the entire shared home: it can contain Gemini data and runtime state unrelated to a setup. ai-stp moves only declared surfaces and keeps config separate from antigravity-cli.
How the setup is assembled
- Discovery checks native directories and separates authored components from runtime state.
- The passport records scope, component, source, and the exact plugin or resource version.
- The assembler selects a project or global projection and refuses to route instruction into an unsupported directory.
- The public
antigravity-setup-systemreceives the exact plan and applies it to the appropriate Gemini-home or project surface.
For Antigravity CLI, skill is reusable workflow, agent is a specialized role, plugin is a deployable bundle, hook is an event, MCP is an external service, command is a workflow, and setting is the CLI JSON profile. Each kind stays on its native surface.
When to choose Antigravity CLI
Choose it when you want a Gemini-oriented workflow with shared skills and agents while keeping project resources and plugin boundaries explicit. For a safe migration, do not copy all of ~/.gemini; inspect discovery and build an exact plan first.
Links
- Antigravity CLI plugins and skills
- Antigravity CLI settings
- Antigravity CLI features and subagents
- Public NDDev OpenNetwork antigravity-setup-system
Trust boundary
The shared Gemini home raises the cost of mistakes: a plugin or hook can affect several projects. Review manifests, scripts, MCP endpoints, exact pin, and rollback before applying a setup.
Observe → separate shared and project surfaces → passport → exact plan → provider write.