v5.3.2 is out. Since 5.3.1, a failed connect no longer shows “Connected”. Read the release · CHANGELOG
Open source · MIT · v5.3.2

GitHub Codespaces in Cursor, Antigravity and VS Code. One command center.

Antigravity Codespaces Pro is a free, MIT-licensed extension that connects VS Code-based editors such as Cursor and Google Antigravity to GitHub Codespaces over SSH using the GitHub CLI. Connect, switch accounts, fix SSH and keep agent sessions alive without leaving Cursor, Antigravity, VS Code, Windsurf or VSCodium.

Last updated 21 October 2026Free and open sourceUses your own GitHub account and billingQuick Connect Alt+C
The problem

Your editor is local. Your workspaces aren't.

Running GitHub Codespaces from an AI-first editor usually means hand-written SSH config, account juggling and connections that drop in the middle of an agent's task.

01

Account switching

Personal, work and client codespaces live under different GitHub accounts.

02

SSH setup

Host entries, platform settings and host keys all have to be right before anything connects.

03

Opaque failures

Errors like exit 127 or 255 rarely say that the real cause was gh auth.

04

Dropped sessions

Long-running AI agent work dies when an idle tunnel times out.

Capabilities

Everything for remote development, inside the editor.

Built on the official GitHub CLI and your IDE's Remote-SSH support. Nothing runs on a third-party server.

Visual Cloud Hub

Every codespace as a card or a list row, with its state, repository, branch, machine and owning account. Start, stop, rebuild, create and delete from one place.

repo-a ● Available · main · 4-core
repo-b ○ Shutdown · feat/auth · 2-core

Multi-account management

Switch between GitHub accounts signed in to gh. The hub, the SSH hosts and the usage numbers follow the active account.

gh auth switch → work-account
✓ 4 codespaces · SSH hosts synced

Quick Connect

A keyboard-first launcher for any codespace, plus Reconnect to Last.

Alt + C › repo-a · main

Setup Doctor

Checks gh, the SSH client, Remote-SSH and auth state, with one-click fixes and a token-redacted report.

✓ gh · ✓ ssh · ! scope missing

Safer SSH

Synced host config, accept-new host key checking with its own known_hosts file, and auto-set remotePlatform.

Host cs.repo-a.main
 StrictHostKeyChecking accept-new

Keepalive for AI agents

SSH keepalive settings keep tunnels open through long agent runs in Cursor or Antigravity.

ServerAliveInterval 30
ServerAliveCountMax 10

Forwarded ports

See ports a codespace exposes and open them in the browser in one click.

:3000 web · :5432 db

Real usage analytics

Compute and storage straight from GitHub's billing API. If it can't be read, it says so.

42.6 / 180 core-hrs example
How it works

Your editor, your GitHub account, a direct path.

The extension drives the official GitHub CLI and your IDE's Remote-SSH extension. Credentials stay in gh and the IDE's SecretStorage.

Your IDE

Cursor, Antigravity, VS Code, Windsurf or VSCodium with the extension and Remote-SSH.

GitHub CLI

gh codespace ssh under the account you picked. Preflight catches auth and scope problems first.

Your codespace

A Linux container on GitHub, billed to your own account or organization.

Setup

Set it up in your IDE.

Same steps everywhere: install the gh CLI, sign in, add the extension and a Remote-SSH extension, then connect.

  1. Install the GitHub CLI from cli.github.com and run gh auth login -s codespace.
  2. Open the Extensions view; Antigravity uses Open VSX, then search Antigravity Codespaces Pro.
  3. Remote-SSH: Antigravity's remote support, or jeanp413.open-remote-ssh.
  4. Run Codespaces: Setup Doctor to check everything.
  5. Press Alt+C and pick a codespace.
  6. Full walkthrough: full Google Antigravity setup guide.
terminal · Google Antigravity
# sign in once
gh auth login -s codespace
# install the extension
antigravity --install-extension nirbhay-hiwse.antigravity-codespaces
✓ ready, press Alt+C to connect
  1. Install the GitHub CLI from cli.github.com and run gh auth login -s codespace.
  2. Open Extensions (Ctrl+Shift+X); Cursor serves Open VSX, then search Antigravity Codespaces Pro.
  3. Remote-SSH: anysphere.remote-ssh (bundled).
  4. Run Codespaces: Setup Doctor to check everything.
  5. Press Alt+C and pick a codespace.
  6. Full walkthrough: full Cursor setup guide.
terminal · Cursor
# sign in once
gh auth login -s codespace
# install the extension
cursor --install-extension nirbhay-hiwse.antigravity-codespaces
✓ ready, press Alt+C to connect
  1. Install the GitHub CLI from cli.github.com and run gh auth login -s codespace.
  2. Install the .vsix from the latest release (the Marketplace still has 4.3.0), then search Antigravity Codespaces Pro.
  3. Remote-SSH: ms-vscode-remote.remote-ssh.
  4. Run Codespaces: Setup Doctor to check everything.
  5. Press Alt+C and pick a codespace.
terminal · VS Code
# sign in once
gh auth login -s codespace
# install the extension
code --install-extension antigravity-codespaces-5.3.2.vsix
✓ ready, press Alt+C to connect
  1. Install the GitHub CLI from cli.github.com and run gh auth login -s codespace.
  2. Open Extensions; Windsurf uses Open VSX, then search Antigravity Codespaces Pro.
  3. Remote-SSH: none: use Windsurf's built-in SSH (don't install open-remote-ssh or Microsoft Remote-SSH, they conflict).
  4. Run Codespaces: Setup Doctor to check everything.
  5. Press Alt+C and pick a codespace.
terminal · Windsurf
# sign in once
gh auth login -s codespace
# install the extension
windsurf --install-extension nirbhay-hiwse.antigravity-codespaces
✓ ready, press Alt+C to connect
  1. Install the GitHub CLI from cli.github.com and run gh auth login -s codespace.
  2. Open Extensions; VSCodium uses Open VSX, then search Antigravity Codespaces Pro.
  3. Remote-SSH: jeanp413.open-remote-ssh.
  4. Run Codespaces: Setup Doctor to check everything.
  5. Press Alt+C and pick a codespace.
terminal · VSCodium
# sign in once
gh auth login -s codespace
# install the extension
codium --install-extension nirbhay-hiwse.antigravity-codespaces
✓ ready, press Alt+C to connect

The VS Code Marketplace currently has an older version (4.3.0). The latest, 5.3.2, is on Open VSX and as a .vsix in the latest GitHub release.

Usage, from the source

Know exactly how much quota is left.

The extension reads GitHub's billing API for the active gh account, which needs the user scope. Compute and storage are separate quotas and are never added together.

PlanCompute / monthStorage / month
GitHub Free120 core-hours15 GB-month
GitHub Pro180 core-hours20 GB-month
OrganizationsNo free quota, billed to the org

Source: GitHub Docs, About billing for Codespaces.

For AI agents

Let your IDE's agent set it up.

Paste this into the agent in Cursor, Antigravity, Windsurf or Codex. It installs and configures the extension and stops to ask before signing you in.

agent prompt
Set up the "Antigravity Codespaces Pro" extension (ID: nirbhay-hiwse.antigravity-codespaces) in this IDE so I can connect to my GitHub Codespaces over SSH.

Follow https://github.com/Nir-Bhay/antigravity-codespaces/blob/main/AGENT_SETUP.md step by step:
1. Detect which IDE and operating system this is.
2. Check that the GitHub CLI (gh) and an OpenSSH client are installed. Install whatever is missing.
3. Install the extension from Open VSX, or from the latest .vsix release if this IDE cannot reach Open VSX.
4. Install the Remote-SSH extension the guide lists for this IDE. In Windsurf, use the built-in SSH and install nothing.
5. Ask me before running "gh auth login -s codespace", and let me finish the browser sign-in myself.
6. Run "Codespaces: Setup Doctor", fix what it reports, and tell me exactly what you changed.
Do not delete any codespace and do not edit anything in ~/.ssh/config outside the blocks this extension manages.
FAQ

Questions developers ask.

How do I connect Cursor to GitHub Codespaces?

Install the GitHub CLI and run gh auth login -s codespace. Install Antigravity Codespaces Pro from Open VSX in Cursor; Cursor's bundled anysphere.remote-ssh is used automatically. Run Codespaces: Setup Doctor, then press Alt+C and pick a codespace.

Does it work in Google Antigravity?

Yes. Antigravity installs extensions from Open VSX. Search for Antigravity Codespaces Pro, install it, and connect through Antigravity's remote support or the Open Remote - SSH extension.

Why does the official GitHub Codespaces extension not work in Cursor or Antigravity?

These editors install extensions from Open VSX, and GitHub's Codespaces extension and Microsoft's Remote-SSH extension are not published there. Antigravity Codespaces Pro is published on Open VSX and connects over plain SSH through the GitHub CLI instead.

Which Remote-SSH extension should I use?

Cursor: anysphere.remote-ssh (bundled). VS Code: ms-vscode-remote.remote-ssh. VSCodium and Kiro: jeanp413.open-remote-ssh. Windsurf: its built-in SSH only; do not install another Remote-SSH extension.

Why does my codespace disconnect during long AI agent runs?

Either the network drops an idle SSH connection, or GitHub stops the codespace after its idle timeout. The extension writes SSH keepalive settings (ServerAliveInterval 30, ServerAliveCountMax 10) for the first; the second is a setting in your GitHub Codespaces preferences.

Which version is on the VS Code Marketplace?

The Marketplace currently has an older version (4.3.0). The latest, 5.3.2, is on Open VSX and as a .vsix in the GitHub release.

Is it free?

The extension is free and open source under MIT. "Pro" is part of the name, not a paid plan. Codespaces usage itself is billed by GitHub to your account or organization.

Where do the usage numbers come from?

Only from GitHub's billing API for the active gh account, which needs the user scope. If the API fails, the extension shows "Usage unavailable" with the reason. It never estimates.

Bring your codespaces into your editor.

Free, open source and working with the GitHub account you already have.