antigravity-cli

Operate the Antigravity CLI for plugins, authentication, sandboxing, and delegated coding tasks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Operating the Antigravity CLI (agy) from an agent environment requires knowing its two-layer command model, non-interactive flags, auth flow, and file locations; this Skill provides the operator guide so commands are run correctly the first time. ## Core Features & Use Cases - CLI Operation: Install, update, smoke-test, and run non-interactive agy --print one-shots through the terminal tool. - Debugging Support: Diagnose auth, sandbox, permission, and plugin state by reading settings, keybindings, conversations, and cli-*.log files. - Delegation Patterns: Hand features, fixes, and reviews to Antigravity via one-shot prompts, bounded background runs, PTY+tmux interactive sessions, or parallel git-worktree fan-out. - Use Case: Ask the agent to have Antigravity review a diff with a specific Gemini model, then poll the background process and collect the plain-text result. ## Quick Start Use the antigravity-cli skill to verify the agy installation and run a one-shot prompt summarizing this repository.

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 non-interactively?▼

Use `agy --print` or `agy -p` with your prompt to run a one-shot that exits after completion. Add `--model` to pick the engine and `--print-timeout` to bound long runs, since the default timeout is 5 minutes.

How do I delegate coding tasks to the Antigravity CLI?▼

Run `agy -p` with the task prompt in the target repo, optionally in the background with completion notification. For parallel work, create one git worktree per task and launch an independent `agy -p` in each.

Does agy support JSON output or a max-turns flag?▼

No. `agy -p` returns plain text only, with no `--output-format json` and no result envelope containing session_id or cost. Runs are bounded by `--print-timeout` rather than a `--max-turns` flag.

How does Antigravity CLI authentication work?▼

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.

Where are Antigravity CLI logs and settings stored?▼

Everything lives under `~/.gemini/antigravity-cli/`: settings.json, keybindings.json, conversations/, history.jsonl, and logs at `log/cli-*.log`. Check the latest log file first when diagnosing failures.

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

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