antigravity-cli

Operate the Antigravity CLI for plugins, authentication, sandboxing, and non-interactive coding-agent runs.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill antigravity-cli-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: antigravity-cli
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/autonomous-ai-agents/antigravity-cli
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill antigravity-cli-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Operating the Antigravity CLI (agy) requires knowing which commands belong to the shell wrapper versus the interactive TUI, how to run non-interactive one-shot prompts, and where to find settings, logs, and plugin state. This Skill provides an operator guide so an agent can install, verify, debug, and delegate work to Antigravity without trial and error. ## Core Features & Use Cases - Wrapper command operations: Install, update, smoke-test, and manage plugins via agy install, agy update, and agy plugin subcommands. - Delegation patterns: Run one-shot prompts with agy -p, background long tasks with completion notifications, drive interactive PTY/tmux sessions, and fan out parallel instances across git worktrees. - Debugging and inspection: Read settings, keybindings, conversation history, and cli-*.log files under ~/.gemini/antigravity-cli/ to diagnose auth, sandbox, and permission issues. - Use Case: Ask the agent to have Antigravity review a diff for bugs using the Gemini 3.1 Pro model, then poll the background process and collect the plain-text result. ## Quick Start Ask the agent to verify the Antigravity CLI installation by running agy --version and agy plugin list through the terminal tool.

Frequently Asked Questions about antigravity-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a non-interactive prompt with the Antigravity CLI?▼

Use `agy -p` or `agy --print` followed by your prompt to run a one-shot non-interactive command that exits after completion. Select the model with `--model` and bound the run with `--print-timeout` since there is no `--max-turns` flag.

How do I manage plugins in the Antigravity CLI?▼

Use the `agy plugin` subcommands: list, import, install, uninstall, enable, disable, validate, and link. Plugins stage under ~/.gemini/antigravity-cli/plugins/<plugin_name>/ and can bundle skills, agents, rules, MCP servers, and hooks.

Does agy -p support JSON output like Claude Code?▼

No, `agy -p` returns plain text only. There is no `--output-format json` flag and no result envelope with session_id or cost data, so parse stdout directly instead of expecting a JSON object.

How does Antigravity CLI authentication work over SSH?▼

The CLI tries the OS secure keyring first, then falls back to browser-based Google sign-in. Over SSH it prints an authorization URL and expects the auth code pasted back; `/logout` removes saved credentials.

Why does agy help not show slash commands like /config or /permissions?▼

`agy help` only shows the shell wrapper surface such as install, update, and plugin commands. Slash commands like `/config`, `/permissions`, and `/skills` exist only inside a running interactive `agy` TUI session.

Where do I look when the Antigravity CLI fails?▼

Check the logs at ~/.gemini/antigravity-cli/log/cli-*.log first, reading them with a file reader rather than cat. Also inspect settings.json and confirm the install with `command -v agy` and `agy --version`.