GitHub Codespaces in Google Antigravity: a step-by-step setup

By Nirbhay Hiwse · 21 October 2026 · 6 min read

Short answer: Install the GitHub CLI, run gh auth login -s codespace, install Antigravity Codespaces Pro from Open VSX, use Antigravity's own remote support or jeanp413.open-remote-ssh, run Codespaces: Setup Doctor, then press Alt+C and pick a codespace.

This guide takes you from a fresh Google Antigravity install to an open codespace. It takes about ten minutes, most of it waiting for installs.

What do you need before you start?

Google Antigravity installed and up to date.
A GitHub account that can create codespaces, with at least one codespace or a repository to create one from.
An OpenSSH client. On Windows 10 and 11 it is usually present; check with ssh -V.

What is remote development in Google Antigravity with Codespaces?

Remote development in Google Antigravity means the editor runs on your machine while the code, terminal and build run in a codespace on GitHub. The steps below set that up over SSH.

Step 1: How do I install the GitHub CLI?

install gh

# Windows
winget install --id GitHub.cli --source winget
# macOS
brew install gh

On Linux, use GitHub's official package repositories as described in the gh install guide. Restart Google Antigravity afterwards so it sees the new PATH.

Step 2: How do I sign in with the codespace scope?

gh auth login -s codespace
gh auth status   # should list 'codespace' under Token scopes

Step 3: How do I install the extension?

Open the Extensions view, search for Antigravity Codespaces and install the one published by nirbhay-hiwse. Or use the command line:

install extension

antigravity --install-extension nirbhay-hiwse.antigravity-codespaces

Step 4: Which Remote-SSH should I use?

Microsoft's Remote-SSH is not available in Antigravity. Use Antigravity's own remote support, or install jeanp413.open-remote-ssh from Open VSX. Setup Doctor can install it for you.

Step 5: How do I run Setup Doctor?

Open the Command Palette and run Codespaces: Setup Doctor. Fix anything it marks in red; each item has a button.

Step 6: How do I connect?

Press Alt+C, choose a codespace, and a new window opens inside it. If it is stopped, turn it on from the Cloud Hub first.

On macOS, if antigravity is not on PATH, the CLI is at /Applications/Antigravity.app/Contents/Resources/app/bin/antigravity.

What if it does not connect?

Exit code 255: run gh auth status; usually the scope is missing or the codespace is stopped.
Exit code 127: the platform is wrong; Setup Doctor sets it to Linux.
Anything else: see Errors and alerts.

Other editors: Windsurf and the Remote-SSH comparison.

Frequently asked questions

Which scope does the GitHub CLI need?

The codespace scope. Run gh auth login -s codespace, then check that gh auth status lists codespace under Token scopes.

What does exit code 255 mean?

Usually the codespace scope is missing or the codespace is stopped. Run gh auth status to check.

What does exit code 127 mean?

The platform is wrong. Codespaces run Linux, and Setup Doctor sets the platform to Linux.

Found something wrong or out of date? Open an issue or edit the source of this page in a pull request.