Command reference · Antigravity CLI

agy --project <name>

Explicitly sets which project to use at startup.

agy --project <name> is a startup flag for the terminal invocation (not a slash command) and was introduced, according to the changelog, together with --new-project in version 1.0.12. It explicitly determines at startup which existing project is used, instead of the CLI automatically deriving the project from the current working directory. It thus complements agy --new-project <name>: while --project loads an existing project, --new-project always creates a completely new one. Both flags help you avoid relying on automatic project detection at startup — for example when several projects live in the same parent directory, or when a script invokes agy from a different working directory. Like --new-project, --project is only relevant at startup, not usable within a running session.