agy --model <name>

Sets which model to use at startup.

agy --model <name> sets the reasoning model when starting the CLI. Interactive sessions fall back to the default model with a warning if the model can't be resolved; in print mode (-p) the CLI instead hard-fails since 1.1.2 with a non-zero exit code and a list of available models. Available names come from the agy models subcommand.

✅ WHEN TO USE IT?

Start directly with a specific model

agy --model="Gemini 3.1 Pro"

Make sure a script uses exactly the intended model

agy --model <name> -p "<prompt>" hard-fails on a wrong name instead of silently using a different model

⛔ WHEN NOT TO?

The model choice should persist for all future sessions

--model only applies to the current launch, not persistently.

Better: Use /model inside a running agy session, which persists the model across sessions

SOURCES

Antigravity CLI CHANGELOG (GitHub) ↗ raw.githubusercontent.com
Antigravity Doku: Models ↗ antigravity.google