gemini<\/code> binary alive if you would rather not switch yet.<\/p>\n\n\n\nAntigravity CLI vs Antigravity, the desktop app<\/h2>\n\n\n\n
The Antigravity brand covers two separate products, and mixing them up wastes an afternoon. Antigravity, sometimes labelled Antigravity 2.0, is a desktop IDE, a graphical application you install and open like an editor. The Antigravity CLI is a terminal tool whose binary is called agy<\/code>, and that is what this article installs. They share an account and some configuration, but you install and run them independently.<\/p>\n\n\n\nThe CLI exists because Google is retiring the Gemini CLI. After 18 June 2026 the Gemini CLI stops serving requests for free, Pro, and Ultra accounts. Teams on a paid Gemini Code Assist Standard or Enterprise licence keep the old tool with continued model updates, so this deadline mainly hits individual developers. If you are one of them, the fastest path is to set up the Gemini CLI<\/a> knowledge you already have and carry it over, because the workflow concepts map across closely.<\/p>\n\n\n\nPrerequisites<\/h2>\n\n\n\n
You need very little to get started:<\/p>\n\n\n\n
\n- A 64-bit Linux, macOS, or Windows machine with outbound HTTPS access<\/li>\n\n\n\n
- A Google account. A free account works during the preview with generous rate limits, so you do not need a paid Gemini plan<\/li>\n\n\n\n
curl<\/code> on Linux and macOS, or PowerShell on Windows<\/li>\n\n\n\n- A modern CPU that exposes AES hardware instructions (every recent physical CPU does, but virtual machines need one extra setting, covered below)<\/li>\n<\/ul>\n\n\n\n
Install the Antigravity CLI on Ubuntu 26.04<\/h2>\n\n\n\n
Forget anything you read about an npm<\/code> package. The old gemini-cli<\/code> npm package is deprecated, and the Antigravity CLI ships as a single native binary through an official installer script. On Linux and macOS the whole install is one line:<\/p>\n\n\n\ncurl -fsSL https:\/\/antigravity.google\/cli\/install.sh | bash<\/code><\/pre>\n\n\n\nThe script detects your platform, pulls the matching build, verifies a checksum, and drops a binary called agy<\/code> into ~\/.local\/bin<\/code>. On a minimal server that directory is often missing from your PATH<\/code>, which is the first thing that trips people up. Add it for the current shell:<\/p>\n\n\n\nexport PATH=\"$HOME\/.local\/bin:$PATH\"<\/code><\/pre>\n\n\n\nNow confirm the binary runs and prints a version string:<\/p>\n\n\n\n
agy --version<\/code><\/pre>\n\n\n\nThe installer adds the same PATH<\/code> line to your shell profile, so new terminals pick it up automatically. The full install plus version check looks like this on a fresh Ubuntu 26.04 box:<\/p>\n\n\n\n![\"Installing](\"https:\/\/computingforgeeks.com\/wp-content\/uploads\/2026\/06\/install-antigravity-cli-ubuntu-2604.png\" "\\"\\"")
<\/figure>\n\n\n\nThat single binary is around 180 MB because the whole agent runtime is compiled in. There is also a separate Python package, google-antigravity<\/code>, but that is the SDK for building on top of the agent, not the CLI. Install the SDK only if you are writing code against it.<\/p>\n\n\n\nFix the “Illegal instruction” AES error<\/h2>\n\n\n\n
If your very first agy<\/code> command dies instantly with a fatal error and a core dump, you are almost certainly on a virtual machine. The binary is compiled with hardware AES enabled, and it refuses to start when the CPU it sees does not expose the AES instruction set:<\/p>\n\n\n\nFATAL ERROR: This binary was compiled with aes enabled, but this feature is not available on this processor (go\/sigill-fail-fast).\nIllegal instruction (core dumped)<\/code><\/pre>\n\n\n\nPhysical machines with any recent Intel or AMD CPU never hit this. Virtual machines do, because the default emulated CPU model masks host features like AES. The fix is to expose the host CPU to the guest. On Proxmox or plain KVM, set the CPU type to host<\/code> and cold-boot the VM so the new model attaches:<\/p>\n\n\n\nqm set 151 --cpu host\nqm stop 151 && qm start 151<\/code><\/pre>\n\n\n\nA plain reboot is not enough, because the CPU model only changes when the VM process restarts. After the cold boot, check that the AES flag is now visible inside the guest, then run the version command again. It should return cleanly:<\/p>\n\n\n\n![\"Fixing](\"https:\/\/computingforgeeks.com\/wp-content\/uploads\/2026\/06\/antigravity-cli-aes-illegal-instruction-fix.png\" "\\"\\"")
<\/figure>\n\n\n\nOn other hypervisors the idea is identical even if the command differs. In VMware set the guest to pass through the host CPU, and in cloud VMs pick an instance type whose vCPUs expose AES, which nearly all of them do.<\/p>\n\n\n\n
Sign in with your Google account<\/h2>\n\n\n\n
There is no login<\/code> subcommand. Authentication fires the first time you run anything that needs the model. Trigger it with a throwaway prompt:<\/p>\n\n\n\nagy -p \"say hi\"<\/code><\/pre>\n\n\n\nOn a desktop the tool opens your browser. Over SSH it prints an authorization URL and waits. Open that URL in a browser signed into the Google account you want to use, approve the consent screen, and the callback page hands you an authorization code. Paste that code back into the terminal and the CLI exchanges it for a token. A free account is enough during the preview, so this works without any paid subscription.<\/p>\n\n\n\n![\"Antigravity](\"https:\/\/computingforgeeks.com\/wp-content\/uploads\/2026\/06\/antigravity-cli-google-signin-ubuntu.png\" "\\"\\"")
<\/figure>\n\n\n\nThis is a real change from the Gemini CLI, which read a GEMINI_API_KEY<\/code> environment variable. Any scripts or CI jobs that exported that variable need rethinking, because the Antigravity CLI keeps credentials in the system keyring or a token file instead.<\/p>\n\n\n\nWhere the token and config actually live<\/h2>\n\n\n\n
Several early write-ups claim the credentials sit in ~\/.config\/agy\/credentials.json<\/code>. They do not. On Linux the OAuth token is a plain file at ~\/.gemini\/antigravity-cli\/antigravity-oauth-token<\/code>, and the rest of the configuration lives under ~\/.gemini<\/code> as well, including the MCP server config and your saved conversations. On macOS the token goes into the Keychain under an entry named “Antigravity Safe Storage” rather than a file.<\/p>\n\n\n\nls ~\/.gemini\/antigravity-cli\/\nls ~\/.gemini\/config\/<\/code><\/pre>\n\n\n\nThat token file is the piece you copy to reuse a session on a headless server or in CI, so it is worth knowing the real path:<\/p>\n\n\n\n![\"Antigravity](\"https:\/\/computingforgeeks.com\/wp-content\/uploads\/2026\/06\/antigravity-cli-token-config-location-linux.png\" "\\"\\"")
<\/figure>\n\n\n\nOne practical warning for unattended servers. The interactive paste prompt closes after roughly thirty seconds, which is too short to relay a human sign-in through a chat or a ticket. Authenticate in a shell where you can paste the code yourself within seconds, or sign in once on a workstation and copy the token file across. The official guidance for CI is exactly that: cache the token and mount it on the runner.<\/p>\n\n\n\n
Install on macOS and Windows<\/h2>\n\n\n\n
macOS uses the same installer. On an Apple Silicon Mac the script detects the darwin_arm64<\/code> build and drops agy<\/code> into ~\/.local\/bin<\/code> just as it does on Linux:<\/p>\n\n\n\ncurl -fsSL https:\/\/antigravity.google\/cli\/install.sh | bash<\/code><\/pre>\n\n\n\nIf your shell profile is managed by a tool like nix-darwin or Home Manager, the installer cannot edit the read-only profile and prints a non-fatal warning. The binary still works; just call it by its full path ~\/.local\/bin\/agy<\/code> or add the directory to your managed config yourself. Windows uses a PowerShell one-liner instead:<\/p>\n\n\n\nirm https:\/\/antigravity.google\/cli\/install.ps1 | iex<\/code><\/pre>\n\n\n\nWindows installs the same native binary, so there is no Node.js or npm in the loop. The sign-in flow is identical to the desktop path on macOS, with the browser opening automatically.<\/p>\n\n\n\n
Run your first agentic task<\/h2>\n\n\n\n
The point of the Antigravity CLI is not chatting, it is letting an agent do multi-step work on its own. Print mode runs a single prompt non-interactively and lets the agent use tools to reach the goal. Two flags matter here. --add-dir<\/code> points the agent at a real working directory, and --dangerously-skip-permissions<\/code> auto-approves the shell and file actions so the run does not stop to ask. Only use that second flag in a throwaway directory or a disposable VM.<\/p>\n\n\n\nmkdir -p ~\/portscanner\nagy --add-dir ~\/portscanner --dangerously-skip-permissions \\\n -p \"Build a Python port scanner with pytest tests, then run them\"<\/code><\/pre>\n\n\n\nFrom that single sentence the agent installed the python3-venv<\/code> package, wrote a clean port-scanner module and an argparse CLI, added a pytest file with an open-port and a closed-port case, created a virtual environment, installed pytest and flake8 into it, checked the formatting, and ran the suite. The tests passed and the files landed in the directory we pointed it at:<\/p>\n\n\n\n![\"Antigravity](\"https:\/\/computingforgeeks.com\/wp-content\/uploads\/2026\/06\/antigravity-cli-agentic-task-pytest-passed.png\" "\\"\\"")
<\/figure>\n\n\n\nSkip the --add-dir<\/code> flag and you get a surprise. In print mode the agent defaults to a scratch workspace under ~\/.gemini\/antigravity-cli\/scratch\/<\/code> rather than your current directory, so your new files appear to vanish. Always name the directory you want the agent to work in, and the output stays where you expect.<\/p>\n\n\n\nThe async, multi-agent orchestration is the headline difference from the Gemini CLI. Larger jobs run in the background while you keep using the terminal, which is the same model that terminal agents like Claude Code<\/a> and the Codex CLI<\/a> popularised. If you are weighing up the field, our comparison of open-source terminal coding agents<\/a> is a useful map.<\/p>\n\n\n\nMigrate from the Gemini CLI<\/h2>\n\n\n\n
Treat the 18 June 2026 cutoff as real. After that date the Gemini CLI and the Gemini Code Assist IDE extensions stop answering for free, Pro, and Ultra accounts. The good news is that the concepts you built around the old tool carry over. Agent skills, hooks, subagents, and extensions all exist in the Antigravity CLI, although Google is explicit that there is no one-to-one parity at launch, so expect to re-test custom setups rather than lift them verbatim.<\/p>\n\n\n\n
The migration steps are short. Install the Antigravity CLI as above, sign in once, then port your prompts and any project configuration. If you keep a command reference for the old tool, our Gemini CLI cheat sheet<\/a> is a good side-by-side while you map the equivalents. Enterprise teams with a Code Assist licence can stay on the Gemini CLI for now, but everyone else should plan the switch before the deadline rather than on it.<\/p>\n\n\n\nTroubleshooting<\/h2>\n\n\n\n
These are the snags we actually hit while testing, with the fix for each.<\/p>\n\n\n\n
“Illegal instruction (core dumped)” on first run<\/h3>\n\n\n\n
The CPU lacks AES instructions, which only happens on virtual machines with a masked CPU model. Set the guest CPU to pass through the host, as shown in the AES section above, and cold-boot the VM. Confirm with grep -o aes \/proc\/cpuinfo<\/code> before retrying.<\/p>\n\n\n\n“agy: command not found” right after install<\/h3>\n\n\n\n
The binary is in ~\/.local\/bin<\/code>, which is not on the PATH<\/code> of a fresh shell. Run export PATH=\"$HOME\/.local\/bin:$PATH\"<\/code> for the session, open a new terminal so the profile change takes effect, or call the binary by its full path.<\/p>\n\n\n\nSign-in keeps timing out over SSH<\/h3>\n\n\n\n
The pasted-code window is short. Complete the browser step first, have the code on your clipboard, then run the auth command and paste immediately. For servers you manage regularly, sign in once on a workstation and copy ~\/.gemini\/antigravity-cli\/antigravity-oauth-token<\/code> to the same path on the server.<\/p>\n\n\n\nThe agent’s files are nowhere to be found<\/h3>\n\n\n\n
Without --add-dir<\/code>, print mode writes to the scratch workspace under ~\/.gemini\/antigravity-cli\/scratch\/<\/code>. Re-run with --add-dir \/path\/to\/project<\/code> pointed at the directory you actually want, and reference that same path in the prompt.<\/p>\n\n\n\nWith the binary installed, the AES gotcha out of the way, and a token cached, the Antigravity CLI behaves like a capable background agent rather than a chat box. Point it at a directory, give it a concrete task, and let it work while you move on to the next thing.<\/p>\n","protected":false},"excerpt":{"rendered":"
Google is switching off the Gemini CLI on 18 June 2026 and moving everyone to its replacement, the Antigravity CLI. If you have been driving Gemini from your terminal, that is a hard deadline to migrate, and the new tool is a different binary with a different sign-in flow and a much heavier focus on … Read more<\/a><\/p>\n","protected":false},"author":7,"featured_media":168264,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[39034,690,299],"tags":[17245,669],"cfg_series":[],"class_list":["post-168263","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ai","category-dev","category-how-to","tag-ai","tag-dev"],"_links":{"self":[{"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/posts\/168263","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/comments?post=168263"}],"version-history":[{"count":2,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/posts\/168263\/revisions"}],"predecessor-version":[{"id":168266,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/posts\/168263\/revisions\/168266"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/media\/168264"}],"wp:attachment":[{"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/media?parent=168263"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/categories?post=168263"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/tags?post=168263"},{"taxonomy":"cfg_series","embeddable":true,"href":"https:\/\/computingforgeeks.com\/wp-json\/wp\/v2\/cfg_series?post=168263"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}