How do I install the Agy CLI skill?

Run npx skillmds@latest add alexferrari88/agy-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Agy CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agy CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agy CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Agy CLI?

alexferrari88 (@alexferrari88) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agy CLI by alexferrari88 — Agent Skill

Name: Agy CLI
Author: alexferrari88

Agy CLI

Use Antigravity CLI (`agy`) to run agent sessions, non-interactive prompts, model discovery, project/workspace selection, plugin management, CLI install/update checks, changelog inspection, and conversation resume workflows. Trigger when the user asks to use Antigravity or agy, run an agy prompt, inspect agy models/plugins, install/validate/manage agy plugins, or troubleshoot the Antigravity CLI.

alexferrari88 49a60b0 3 files · 6.2 KB Updated Sep 17, 2026

File contents

Antigravity CLI

Core Workflow

Use agy as an external agent CLI. Prefer read-only discovery first, then choose the narrowest invocation that matches the user's request.

Verify availability with command -v agy and agy --help.
Use read-only checks for orientation: agy models, agy plugin list, and agy changelog.
Prefer non-interactive print mode for automation:

agy --sandbox --mode plan --print-timeout 30s --print 'Reply with exactly: OK'

Use interactive mode only when a human needs to continue the session in a TTY:

agy --prompt-interactive 'Start by inspecting this project and ask before editing.'

Follow local shell-command instructions when running examples. For example, if the workspace requires a wrapper such as rtk, prefix the shell command with that wrapper.

Session Modes

Use --mode plan when the agent should inspect, reason, or propose changes without editing. Use --mode accept-edits only when the user has asked Antigravity to make changes.

Add --sandbox by default when running prompts from automation so terminal restrictions are enabled. Do not use --dangerously-skip-permissions unless the user explicitly asks for it and the risk is acceptable.

Set --print-timeout for print mode. The default is 5 minutes; use a shorter timeout for smoke tests and a longer one for substantial tasks.

Projects And Workspaces

Use --project <id> to target an existing Antigravity project, --new-project to create a project for the session, and repeat --add-dir <path> to add workspace directories.

Use --continue or -c to continue the most recent conversation. Use --conversation <id> when the user provides a specific conversation ID.

Models

Run agy models for the current model list before pinning --model, because available names can change. Pass the model name exactly as printed:

agy --model 'Gemini 3.5 Flash (Low)' --sandbox --mode plan --print 'Summarize this repository.'

Plugins

Use agy plugin list for read-only inspection and agy plugin validate [path] before installing a local plugin. Treat these plugin commands as state-changing: import, install, uninstall, enable, disable, and link.

Do not run agy install or agy update as routine discovery. install configures environment paths and shell settings, and update changes the CLI installation.

Reference

Read references/command-reference.md when exact flag names, subcommands, or observed installed behavior matter.

---name: agy-clidescription: Use Antigravity CLI (`agy`) to run agent sessions, non-interactive prompts, model discovery, project/workspace selection, plugin management, CLI install/update checks, changelog inspection, and conversation resume workflows. Trigger when the user asks to use Antigravity or agy, run an agy prompt, inspect agy models/plugins, install/validate/manage agy plugins, or troubleshoot the Antigravity CLI.---# Antigravity CLI## Core WorkflowUse `agy` as an external agent CLI. Prefer read-only discovery first, then choose the narrowest invocation that matches the user's request.1. Verify availability with `command -v agy` and `agy --help`.2. Use read-only checks for orientation: `agy models`, `agy plugin list`, and `agy changelog`.3. Prefer non-interactive print mode for automation:```bashagy --sandbox --mode plan --print-timeout 30s --print 'Reply with exactly: OK'```4. Use interactive mode only when a human needs to continue the session in a TTY:```bashagy --prompt-interactive 'Start by inspecting this project and ask before editing.'```Follow local shell-command instructions when running examples. For example, if the workspace requires a wrapper such as `rtk`, prefix the shell command with that wrapper.## Session ModesUse `--mode plan` when the agent should inspect, reason, or propose changes without editing. Use `--mode accept-edits` only when the user has asked Antigravity to make changes.Add `--sandbox` by default when running prompts from automation so terminal restrictions are enabled. Do not use `--dangerously-skip-permissions` unless the user explicitly asks for it and the risk is acceptable.Set `--print-timeout` for print mode. The default is 5 minutes; use a shorter timeout for smoke tests and a longer one for substantial tasks.## Projects And WorkspacesUse `--project <id>` to target an existing Antigravity project, `--new-project` to create a project for the session, and repeat `--add-dir <path>` to add workspace directories.Use `--continue` or `-c` to continue the most recent conversation. Use `--conversation <id>` when the user provides a specific conversation ID.## ModelsRun `agy models` for the current model list before pinning `--model`, because available names can change. Pass the model name exactly as printed:```bashagy --model 'Gemini 3.5 Flash (Low)' --sandbox --mode plan --print 'Summarize this repository.'```## PluginsUse `agy plugin list` for read-only inspection and `agy plugin validate [path]` before installing a local plugin. Treat these plugin commands as state-changing: `import`, `install`, `uninstall`, `enable`, `disable`, and `link`.Do not run `agy install` or `agy update` as routine discovery. `install` configures environment paths and shell settings, and `update` changes the CLI installation.## ReferenceRead `references/command-reference.md` when exact flag names, subcommands, or observed installed behavior matter.

Frequently asked questions