Command reference ยท Antigravity CLI
install.sh --skip-aliases
Documented alias flag the shell installer does not accept.
The documentation page antigravity.google/docs/cli/install lists --skip-aliases as a flag meant to skip cleaning up old agy/antigravity shell aliases during installation. However, the bootstrapper script actually shipped at antigravity.google/cli/install.sh (239 lines, checked via curl on 07/27/2026) doesn't recognize this flag: its argument parser only accepts -d/--dir (target directory) and -h/--help. Any other parameter, including --skip-aliases, falls into the *) fallback branch and produces [ERROR] Unknown parameter: --skip-aliases, followed by an abort with exit code 1 - the installation then doesn't happen at all.
On top of that: a search for "alias" in the script returns no hits. The script never makes any changes to shell aliases; it only downloads and verifies the binary and, at the end, internally hands off to agy install (or agy.exe install on Windows). The purpose of the flag described in the docs is therefore currently moot, regardless of the parameter value passed.
On Windows it behaves differently: install.cmd collects unknown parameters in FORWARD_ARGS and appends them to SETUP_FLAGS, and install.ps1 does the same via $passthroughArgs. There, --skip-aliases doesn't cause an abort but gets passed through unchecked to agy.exe install. Whether the binary then evaluates or ignores the parameter can't be determined from the outside - the only observable fact is that the call doesn't fail.
โ WHEN TO USE IT?
Check for yourself before installing which flags the shipped script actually accepts
curl -fsSL https://antigravity.google/cli/install.sh | bash -s -- --help
Only use the flag that's actually supported for adjusting the target; then check and remove old aliases yourself in the shell profile afterward
bash install.sh --dir ~/bin
โ WHEN NOT TO?
Passing --skip-aliases in the piped install, expecting old aliases to be preserved
The script only recognizes -d/--dir and -h/--help; --skip-aliases falls into the *) fallback, prints "[ERROR] Unknown parameter: --skip-aliases" and aborts with exit code 1 before anything is even installed.
Better: Run the script without this flag, or check beforehand via --help which parameters are currently supported
Relying solely on the docs' description of the flag without checking the shipped script
The docs page still lists --skip-aliases, but the script actually shipped live at antigravity.google/cli/install.sh doesn't support it (as of 07/27/2026).
Better: Verify the script yourself via curl and --help before using it, instead of blindly trusting the docs table
SOURCES
- Antigravity CLI docs: Install โ antigravity.google