---
slug: "estebanforge-pi-ask-antigravity"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/EstebanForge/pi-ask-antigravity@main/README.md"
repo: "https://github.com/EstebanForge/pi-ask-antigravity"
source_file: "README.md"
branch: "main"
---
# @estebanforge/pi-ask-antigravity
A [Pi](https://github.com/earendil-works/pi-coding-agent) extension that exposes the **`AskAntigravity`** tool: delegate a self-contained sub-task to Google Antigravity's `agy` CLI and stream its response back into the Pi session.
It is the `AskClaude`-style delegation pattern (from pi-claude-bride extension), pointed at Gemini via `agy`. The tool answers to three names the CLI is known by — **gemini**, **antigravity**, and **agy** — surfaced in its description so the model maps any of them to this single tool.
## Install
```
pi install npm:@estebanforge/pi-ask-antigravity
```
Requires the **`agy` CLI** installed and authenticated. If you don't have it, follow Google's [official install guide](https://antigravity.google/docs/cli/install) for your platform. Then run `agy` once to complete Google OAuth.
The extension resolves `agy` on `$PATH`, or via the `AGY_BIN` environment variable if you want to point at a specific binary.
## Two modes: one-shot vs continued conversation
One tool, two ways to use it — you (or the agent) decide per call:
- **One-shot (isolated)**: omit `conversationId`. agy starts fresh with no memory of prior calls. Use for independent questions.
- **Continued conversation**: pass the `conversationId` returned in a prior call's result (`details.conversationId`, also shown in the result footer). agy resumes that conversation with full context intact — use for follow-ups, multi-turn refinement, or "now do X based on what you just did".
How it works under the hood: `agy -p` does not print the conversation id, so on a fresh run the extension snapshots agy's conversations directory before spawn and discovers the single new `.db` file agy created (the one technique borrowed from [`antigravity-acp`](https://github.com/shubzkothekar/antigravity-acp)'s `scan.ts`). On a continued call it passes `--conversation ` and agy reuses it natively. agy holds all conversation state in its own SQLite DB; this extension is otherwise stateless.
## How it works
```
Pi (orchestrator)
└─ AskAntigravity tool
└─ spawn: agy --add-dir --model [--conversation ] -p
└─ agy runs its OWN tool loop (read / write / edit / exec) inside
└─ stdout streamed as partial tool output
└─ returns agy's final answer text + conversationId (for follow-ups)
```
No ACP server, no SQLite reverse-engineering, no `acpx`, no third-party binary. `agy -p` (print mode) prints its response to stdout, so we capture it directly.
## Model aliases
Verbose `agy models` strings (`Gemini 3.5 Flash (Medium)`) are hostile to natural requests. This extension resolves friendly aliases to the exact string:
| User says | Resolves to |
| --- | --- |
| `flash` | latest Flash, default tier (Medium) |
| `pro` | latest Pro (Pro has no Medium → **High**) |
| `gemini` | alias for `flash` |
| `flash high` | latest Flash, High |
| `pro low` | latest Pro, Low |
| `3.5 flash` | pinned version, default tier |
| `3.1 pro` | pinned Pro version (→ High) |
| `Gemini 3.5 Flash (Medium)` | exact passthrough |
- **Latest** = highest version number available for the family.
- **Default tier**: Flash → Medium, Pro → High. Overridable per-config (below).
- When a tier is unavailable for a family, the nearest is chosen with ties broken toward the higher tier (so "latest and greatest" wins).
## Configuration
`~/.pi/agent/ask-antigravity.json` (global) merged over `.pi/ask-antigravity.json` (project):
```json
{
"defaultModel": "flash",
"defaultThinking": "medium"
}
```
| Key | Default | Description |
| --- | --- | --- |
| `defaultModel` | `flash` | Alias or exact id used when the tool call omits `model`. |
| `defaultThinking` | `medium` | Tier used when an alias doesn't name one. Applies only if the family offers it; otherwise the family default (Pro → High). |
### `/agy` command
Interactive picker for the default model and default thinking. If the project config (`.pi/ask-antigravity.json`) already defines a key, the change is written there so it actually takes effect; otherwise it writes to the global config. Outside TUI (RPC/headless), prints a read-only status snapshot.
## Tool parameters
| Param | Required | Description |
| --- | --- | --- |
| `prompt` | yes | Self-contained task. agy cannot see the Pi conversation. |
| `cwd` | no | Workspace agy runs in. Defaults to the project root. |
| `model` | no | Alias or exact id. Omit for the configured default. |
| `conversationId` | no | Omit for a one-shot (agy starts fresh). Pass the id from a prior call's result (`details.conversationId`) to resume that agy conversation with full context. See [Two modes](#two-modes-one-shot-vs-continued-conversation). |
| `skipPermissions` | no | Pass `--dangerously-skip-permissions`. Needed for mutating tasks. |
| `timeoutMinutes` | no | Hard cap on the run. Default 10. |
## Environment
| Env var | Purpose |
| --- | --- |
| `AGY_BIN` | Path to an `agy` binary; skips `$PATH` lookup |
| `AGY_EXTRA_ARGS` | Extra args appended to every `agy` invocation (raw string) |
| `AGY_CONVERSATIONS_DIR` | Directory where agy writes its conversation SQLite DBs. Defaults to `~/.gemini/antigravity-cli/conversations`. Override only if agy uses a different path on your OS. |
## When to use it
- A second opinion from a different model family on the same problem.
- Gemini-specific reasoning, long-context synthesis.
- An isolated sub-task you want agy to complete end-to-end without driving each step.
agy mutates the workspace itself, so scope calls to sub-tasks where that is the desired contract, not where Pi is concurrently editing the same files.
## Terms of Service notice
Google's [Antigravity ToS](https://antigravity.google/terms) states that using third-party software to access the Service (e.g. driving `agy` from a non-Google editor) is a breach of the Agreement and may be grounds for suspension or termination of your account. `agy` handles its own Google OAuth; this extension only spawns the official binary as a subprocess — but the effect is still a non-Google editor driving the Antigravity service through a third-party tool. **By using this extension against an `agy` session logged into your personal Antigravity account, you accept that risk.**
## License
MIT