Command reference · Antigravity CLI

agy --agent <name>

Selects a custom agent at startup.

agy --agent <name> is likewise a startup flag for the terminal invocation of agy (not a slash command) and was introduced, according to the official changelog, in version 1.1.1. It directly selects a previously defined custom agent at startup, instead of starting with the default agent. Alongside the flag, the changelog also introduced the agent/agents subcommand, which lets you list available custom agents before picking one via --agent <name>. Since version 1.1.6, custom agents can also be defined as Markdown files (agent.md) with YAML frontmatter, which makes using the flag more relevant in practice because agents can be versioned and maintained by a team more easily this way.