Command reference ยท Antigravity CLI
agy --new-project <name>
Creates a new project at startup.
agy --new-project <name> is a startup flag you pass when invoking agy in the terminal (not a slash command), and since version 1.0.12 it directly creates a new project with the given name at startup, instead of loading an existing project.
If you omit <name>, since version 1.1.1 Antigravity CLI automatically assigns the default name "CLI Project" to newly initialized projects, so workspaces stay uniquely identifiable even without an explicit name.
The flag complements agy --project <name>, which instead lets you select an already existing project: --new-project always creates a new project, while --project loads an existing one. Both are pure startup flags for the terminal invocation of agy, not slash commands within a running session.
โ WHEN TO USE IT?
Create a fresh project
Run agy --new-project customer-project-x in the terminal to start immediately in a new project
Quick start without assigning a name
Call agy --new-project without <name> โ the CLI automatically assigns the name "CLI Project"
โ WHEN NOT TO?
Wanting to keep using an existing project
According to the changelog (v1.0.12), --new-project always creates a new project instead of loading an existing one.
Better: Use agy --project <name> at startup
SOURCES
- Antigravity CLI CHANGELOG (GitHub) โ raw.githubusercontent.com
MORE COMMANDS ยท Antigravity CLI