Skip to content

agy-cli Cheatsheet

Quick reference for everything covered in this workshop. All commands verified against antigravity.google/docs.

Installation & Version

curl -fsSL https://antigravity.google/cli/install.sh | bash
agy --help         # Show all flags and subcommands
agy changelog      # Show release notes
agy update         # Self-update
agy install        # Configure PATH and shell aliases

Launch Modes

Mode Command When to use
Interactive agy Default — full conversational session
Seeded interactive agy -i "<prompt>" Start with direction, continue conversationally
Print (headless) agy -p "<prompt>" Single shot, pipe to stdout
Continue last agy -c Resume most recent session
Resume by ID agy --conversation <id> Resume a specific past session
Resume in-session /resume or /switch Switch conversations without leaving agy

Key Flags

Source: agy --help · cli-using

Flag Short Description
--print "<prompt>" -p Non-interactive single prompt
--prompt-interactive "<prompt>" -i Seeded interactive session
--continue -c Resume most recent conversation
--conversation <id> — Resume by conversation ID
--add-dir <path> — Add directory to workspace (repeatable)
--sandbox — Enable terminal sandbox restrictions
--dangerously-skip-permissions — Auto-approve all tool requests (CI only)
--print-timeout <duration> — Timeout for print mode (default: 5m)
--log-file <path> — Override log output path

Note: Model selection and strict mode are set via /model and /permissions slash commands, not CLI flags. See Features docs.

Slash Commands (Interactive Mode)

Source: CLI Features — Core Slash Commands · Using Antigravity CLI

Command Category Purpose
/resume (/switch) Conversation Open conversation picker to resume or switch sessions
/rewind (/undo) Conversation Roll back conversation history to a previous checkpoint
/fork Conversation Branch the current conversation into a parallel isolated workspace — trial risky steps without affecting the original
/rename <name> Conversation Rename the active conversation thread
/permissions Config Set autonomy level: request-review, always-proceed, strict
/model Config Select default reasoning model (persists across sessions)
/config (/settings) Config Open full-screen settings overlay
/keybindings Config Open the interactive keyboard shortcut editor
/statusline Config Customize real-time CLI status bar indicators
/tasks Monitoring Monitor, view logs for, or terminate background tasks
/skills Monitoring Browse local and global agent skills
/mcp Monitoring Configure and manage MCP servers
/agents Monitoring View, manage, and approve subagent actions
/open <path> Utility Open a file in your preferred external editor
/usage Utility Open the inline interactive help manual
/logout Account Log out and clear cached credentials

Quick Tips

Source: Using Antigravity CLI — Quick Tips & Keybindings

Shortcut / Tip Action
@ File path autocomplete (type @ to trigger path suggestions)
! Run terminal commands directly from the prompt
esc esc Clear your prompt box (when no streaming is active)
? Get help and list all slash commands
alt+enter / shift+enter Insert newline without submitting
ctrl+g Edit prompt inside your default shell editor
ctrl+l Clear TUI screen
ctrl+d Exit the CLI session
ctrl+z Suspend CLI to terminal background
ctrl+j (in /agents) Teleport to next pending subagent approval
ctrl+k Fast-approve pending subagent permission from main conversation

Plugin Commands

# List all active plugins (JSON)
agy plugin list

# Import from Gemini CLI
agy plugin import gemini

# Import from Claude Code
agy plugin import claude

# Force re-import (after plugin updates)
agy plugin import gemini --force

# Install a plugin
agy plugin install <name>
agy plugin install <name>@<version>

# Enable / disable
agy plugin enable <name>
agy plugin disable <name>

# Validate a plugin directory
agy plugin validate ./my-plugin

# Generate marketplace link
agy plugin link <marketplace> <target>

Sidecars

Background processes AGY manages for you — launches, restarts, and runs independently of any conversation. Source: antigravity.google/docs/sidecars

# Config locations:
~/.gemini/config/sidecars/<name>/sidecar.json                         # global
~/.gemini/config/plugins/<plugin>/sidecars/<name>/sidecar.json        # plugin-scoped

# Enable (disabled by default) — edit ~/.gemini/config/config.json:
#   { "sidecars": { "<name>": { "enabled": true } } }

# Check logs:
ls ~/.gemini/antigravity/sidecar_data/<name>/logs/

# agentapi (auto-available inside sidecars):
agentapi new-conversation "<prompt>"
agentapi send-message <conversation_id> "<prompt>"

Minimal sidecar.json — background script:

{ "command": "python3", "args": ["worker.py"], "restart_policy": "on-failure" }

Minimal sidecar.json — scheduled recurring task:

{
  "builtin": "schedule",
  "args": ["0 9 * * 1-5", "agentapi", "new-conversation", "Summarise open PRs."]
}

Workspace & Context

# Project config directory:
.agents/                    # settings.json, mcp.json, hooks.json, rules.md, skills/, plugins/

# Global config directory:
~/.gemini/config/           # settings.json, mcp.json, hooks.json, rules.md, skills/, plugins/

# User settings:
~/.gemini/antigravity/settings.json

# Context file (hierarchical: cwd → parent → home):
AGENTS.md

# agy also reads:
.gemini/                    # Gemini CLI config (compatible)

AGENTS.md Pattern

# Project Context

Brief description of what this project is.

## Conventions
- Language: TypeScript, Node 20
- Testing: Jest + Supertest
- DO NOT run database migrations without explicit approval

Useful Patterns

# Review staged changes before commit
git diff --cached | agy -p "Review for bugs, security issues, missing tests."

# Generate docs for a file
cat src/api.ts | agy -p "Generate OpenAPI documentation for all exported functions."

# Analyze logs
tail -n 500 app.log | agy -p "Group these errors by root cause. Output as JSON."

# Multi-dir cross-repo analysis
agy --add-dir ../api --add-dir ../frontend \
    -p "Map data flow from frontend form submission to database write."

# Full headless CI audit (safe)
agy --sandbox --dangerously-skip-permissions \
    -p "Audit for hardcoded secrets and insecure patterns." \
    --print-timeout 5m > audit.md

# Schedule a recurring task (in interactive mode)
# > Schedule a daily code quality report at 9am weekdays.

Multi-Agent Patterns

# Spawn parallel subagents (in interactive mode)
> Spawn a security auditor and a performance auditor in parallel (branch mode).

# Adversarial review
> Spawn an adversarial reviewer subagent — its job is to find reasons to NOT merge this PR.

# Steer mid-task
/btw Focus only on the authentication module, skip the frontend.

# Background task
> In the background, audit all dependencies for known CVEs. Notify me when done.

# Step 1: plan
agy -p "Create a refactoring plan for moving from callbacks to async/await. JSON output." \
  > plan.json

# Step 2: execute
cat plan.json | agy -p "Execute step 1 of this plan."

# Batch: process multiple files
for f in src/*.ts; do
  agy --add-dir "$(dirname $f)" \
      -p "Add JSDoc to all exported functions in $(basename $f)."
done

Official Docs

Topic Link
CLI Overview antigravity.google/docs/cli-overview
Getting Started antigravity.google/docs/cli-getting-started
Using Antigravity CLI (settings, tips, keybindings) antigravity.google/docs/cli-using
Features (plugins, sandbox, slash commands, subagents) antigravity.google/docs/cli-features
Migration from Gemini CLI antigravity.google/docs/gcli-migration
Permissions antigravity.google/docs/permissions
Strict Mode antigravity.google/docs/strict-mode
Plugins antigravity.google/docs/plugins
MCP antigravity.google/docs/mcp
Skills antigravity.google/docs/skills
Rules antigravity.google/docs/rules-workflows
Hooks antigravity.google/docs/hooks
Sidecars antigravity.google/docs/sidecars
Subagents antigravity.google/docs/subagents
Enterprise antigravity.google/docs/enterprise