Command reference ยท Antigravity CLI
agy agent / agy agents
Lists the available custom agents.
agy agent or agy agents is a subcommand of the Antigravity CLI (since version 1.1.1) and lists all available custom agents on the command line before a session starts. Custom agents are defined as a markdown file agent.md with YAML frontmatter, either project-scoped under .agents/agents/<name>/agent.md or globally under ~/.gemini/config/agents/<name>/agent.md. The name found with agy agents can be passed directly to the --agent startup option to start the CLI right away with that agent, for example agy --agent code-reviewer. Within an already running session, the interactive /agents panel instead handles switching between agents as well as monitoring and stopping running subagents. Both approaches complement each other: the subcommand is for looking things up before starting, the panel is for control during the session. The command should be distinguished from agy models, which lists available models instead.
โ WHEN TO USE IT?
Looking up available custom agents before starting
agy agents, to find the exact name for --agent
Specifically selecting a globally defined agent at startup
agy agents shows code-reviewer; then agy --agent code-reviewer starts directly with that agent
โ WHEN NOT TO?
Already in a running session and wanting to switch between agents or monitor subagents
The subcommand only provides a one-time list outside the TUI, but no selection or monitoring function.
Better: use /agents within the running agy
Looking for available models instead of agents
agy agent/agents only lists custom agents, no models.
Better: use agy models to list the available models
SOURCES
- Antigravity CLI CHANGELOG (GitHub) โ raw.githubusercontent.com
- Antigravity CLI docs: /agents โ antigravity.google
MORE COMMANDS ยท Antigravity CLI