@specode/pi-antigravity
Independent Antigravity subscription chat provider for Pi, aligned with the official agy CLI HTTP protocol.
Package details
Install @specode/pi-antigravity from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@specode/pi-antigravity- Package
@specode/pi-antigravity- Version
0.1.5- Published
- Nov 17, 2026
- Downloads
- 814/mo · 814/wk
- Author
- specode
- License
- MIT
- Types
- extension
- Size
- 101.7 KB
- Dependencies
- 0 dependencies · 2 peers
Pi manifest JSON
{
"extensions": [
"./src/index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-antigravity
A Pi extension that adds the Antigravity (antigravity) provider so you can use Gemini, Claude, and GPT-OSS models with your Google Antigravity subscription.
Installation
Requires Node.js >= 22.19.0 and Pi >= 1.5.2.
From npm:
pi install npm:@specode/pi-antigravity
From GitHub:
pi install git:github.com/specode/pi-antigravity
From a local directory for development:
pi install /path/to/pi-antigravity
Run /reload or restart Pi after installing.
If another package registering the antigravity provider is already installed (such as pi-antigravity), remove it first with pi remove npm:pi-antigravity. Only one antigravity provider should be installed at a time. Existing Antigravity credentials in ~/.pi/agent/auth.json continue to work without signing in again.
Usage
- Run
/login, pickSign in with an account→Antigravity, and open the authorization URL in your browser. - Sign in with Google, click Copy to Clipboard on the Antigravity callback page, and paste the
4/...authorization code into Pi. (Do not copy the browser address bar URL, as the page strips its query parameters after loading; a full callback URL withcodeandstateis also accepted if copied before redirect cleanup.) - Run
/modelto pick anantigravitymodel and adjust its thinking effort.
Models
The model list is fetched from Google's Cloud Code API for your account and cached in ~/.pi/agent/models-store.json (refreshed every 4 hours, and restored from cache when starting Pi offline).
| Model ID | Name | Thinking levels | Context | Max output | Images |
|---|---|---|---|---|---|
gemini-4-argon |
Gemini 4 Argon | low, medium, high |
1M | 65.5K | Yes |
gemini-4-hydrogen |
Gemini 4 Hydrogen | low, medium, high, xhigh |
1M | 262.1K | Yes |
gemini-3.8-flash |
Gemini 3.8 Flash | low, medium, high |
1M | 65.5K | Yes |
claude-opus-5-5 |
Claude Opus 5.5 | low, medium, high |
1M | 128K | Yes |
claude-sonnet-5-5 |
Claude Sonnet 5.5 | low, medium, high |
1M | 128K | Yes |
gpt-oss-120b |
GPT-OSS 120B | medium |
131.1K | 32.8K | No |
Notes
- Chat and tool calling only: This extension registers the
antigravitychat provider. It does not add image generation, web search/fetch tools, multi-account rotation, or a quota UI. - Token usage and cost: Prompt, cached, output, and thinking token counts are recorded on each turn. Partial updates retain previously valid counters; malformed counters are ignored, not coerced. If cached tokens exceed the reported prompt total, accounting uses zero uncached input and caps cached input at that total without interrupting generation. A bounded
antigravity.usage_anomalydiagnostic retains valid numeric counters and invalid field names (never raw payloads); anomalous accounting is approximate until corrected by later metadata. Cost fields remain0for subscription usage. - Claude thinking continuity: Consecutive thinking deltas are assembled until their signature, whether it arrives with text or in a separate text-less tail. Old same-model session fragments are reassembled only in the outgoing request; saved sessions are not rewritten. Text, tool calls and already signed blocks remain boundaries. Gemini's distinct signature-bearing parts are preserved.
- Default system prompt compatibility: Google's backend rejects some of Pi's built-in system prompt text with
429 RESOURCE_EXHAUSTED(confirmed for the default opening and one line of the built-in documentation hints). When sending a request, the extension rewrites Pi's built-in prompt wording (the opening, built-in tool summaries and rules, documentation hints, and the project-instruction and skill-list headings) into equivalent text that does not name Pi. Only exact Pi 1.5.2 wording is rewritten; file paths, environment variable names, tool names and schemas, skill entries, other extensions' sections, yourAGENTS.md, custom system prompts, user messages, and session files are passed through unchanged. Google may treat this as circumventing its third-party client detection; use it at your own account's risk. - Existing Cloud Code project required: Your Google account must already have an active Antigravity / Cloud Code Assist project. Automatic GCP project creation and enterprise endpoints are not supported.
Companion Extensions
@specode/pi-subscription-usage: Shows your Antigravity subscription quota (Gemini, Claude and GPT, and Gemini 4 Argon pools) in the footer status bar and via/usage. Works out of the box with theantigravitylogin from this extension.@specode/pi-last-model-effort: Remembers the thinking effort you last picked for each model and restores it when switching models or starting a new TUI session.
Privacy and Safety
- Credentials are stored and refreshed through Pi's own
~/.pi/agent/auth.json. The extension never reads official CLI login files or OS keychain entries. - Requests go only to official Google Cloud Code endpoints (
https://daily-cloudcode-pa.googleapis.comby default) with HTTP redirects disabled. - Access and refresh tokens are never written to model caches, session files, or error messages.
- Claude models receive each tool's original JSON Schema (including
anyOfunions); Gemini and GPT-OSS models receive the legacy encoding observed from the official CLI. - If a model, thinking level, or tool schema (
$ref/$dynamicRefon Gemini and GPT-OSS models, orstrict: "require") is not supported by the backend, the request fails with an explicit error instead of silently downgrading or dropping tools.
Development
# Install dependencies
npm ci
# Run tests
npm test
# Run typecheck, tests, isolated packed-extension smoke check, and package check
npm run check
# Load the extension directly in Pi without installing
pi --no-extensions --offline -e ./src/index.ts --list-models
License
MIT. See THIRD_PARTY_NOTICES.md for protocol references and third-party notices.