antigravity-cli

Operate the Antigravity CLI for plugin management, authentication, and sandbox configuration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Operating the Antigravity CLI (agy) requires knowing the difference between shell wrapper commands and in-session slash commands, plus where settings, logs, and plugin state live. This Skill provides an operator guide so an agent can install, run, debug, and verify agy without guesswork. ## Core Features & Use Cases - Command Reference: Covers wrapper commands (agy help, install, plugin, update, changelog), useful flags like --print and --sandbox, and in-session slash commands such as /config, /permissions, and /agents. - Configuration & Debugging: Documents core paths under ~/.gemini/antigravity-cli/ for settings, keybindings, logs, conversations, and plugin staging, plus permission modes and sandbox behavior. - Use Case: An agent needs to smoke-test an agy installation on a remote VM: it verifies the binary with agy --version, lists plugins, runs a non-interactive agy --print prompt, and reads the latest cli-*.log to confirm clean operation. ## Quick Start Ask the agent to verify the Antigravity CLI installation by running agy --version and agy plugin list through the terminal, then read the settings.json file to review the current configuration.

Frequently Asked Questions about antigravity-cli

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

FAQPage Schema
How do I run Antigravity CLI commands non-interactively?▼

Use agy --print (or agy -p) with a prompt string for one-shot, non-interactive execution, optionally with --print-timeout. For scripted prompts this avoids needing a TTY, unlike interactive mode which requires pty support.

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 the Antigravity CLI work over SSH for authentication?▼

Yes. Over SSH, agy prints a secure authorization URL instead of opening a browser, and you paste the auth code back. It tries the OS secure keyring first, and /logout removes saved credentials.

Why does agy version fail but agy --version works?▼

agy version is interactive and can fail without a real TTY, while agy --version is the safe non-interactive version check. Use --version for scripted verification of the binary.

Where are Antigravity CLI logs and settings stored?▼

Settings live in ~/.gemini/antigravity-cli/settings.json, keybindings in keybindings.json, and logs in ~/.gemini/antigravity-cli/log/cli-*.log. The log directory is the first place to check when diagnosing failures.

What is the difference between agy help and in-session slash commands?▼

agy help shows only the shell wrapper surface (install, plugin, update, changelog). Slash commands like /config, /permissions, and /agents exist only inside a running agy TUI session and are not available on the wrapper.