Antigravity SDK ACP

An unofficial Agent Client Protocol adapter for Google's official google-antigravity Python SDK.

It connects ACP clients such as Zed and JetBrains IDEs to Gemini through either Vertex AI Application Default Credentials or a Gemini Developer API key. It does not use Antigravity account tokens, private APIs, local databases, or the agy CLI.

This project is not affiliated with or endorsed by Google.

Install

Python 3.11+ and uv are required.

uv tool install git+https://github.com/adihex/antigravity-sdk-acp

Authenticate

Vertex AI

Create or select a billing-enabled Google Cloud project, enable Vertex AI, and run:

gcloud services enable aiplatform.googleapis.com --project YOUR_PROJECT_ID
antigravity-sdk-acp --setup

The setup command uses Google's official ADC browser login, sets the ADC quota project, and stores only the selected project ID and location in ~/.config/antigravity-sdk-acp/config.json. Google credentials remain managed by gcloud.

Gemini Developer API

Set an AI Studio key instead:

export GEMINI_API_KEY='...'

Zed

Add a custom External Agent in Zed's AI settings:

{
  "agent_servers": {
    "antigravity-sdk": {
      "type": "custom",
      "command": "antigravity-sdk-acp",
      "args": [],
      "env": {}
    }
  }
}

Restart Zed or reload the workspace, then select Antigravity SDK from the External Agent picker.

Safety

• File creation, file editing, and shell commands require an ACP permission decision.
• SDK workspace policies restrict file tools to the project root and additional ACP workspace directories.
• Read-only tools remain available without confirmation.
• Session metadata and SDK conversation state stay on the local machine.

Development

uv sync --all-groups
uv run ruff format --check .
uv run ruff check .
uv run pytest -q
uv run mypy src tests
uv run ty check
uv run bandit -r src -ll
uv build

License

Apache-2.0. The Google Antigravity SDK and other dependencies retain their own licenses.