mirror of https://github.com/garrytan/gstack.git
72 lines
2.8 KiB
Markdown
72 lines
2.8 KiB
Markdown
# Google Antigravity (Agy) Integration
|
|
|
|
gstack supports Google Antigravity (Agy) as a first-class agent host. This integration allows you to generate and run Agy-compatible skills, load them dynamically via the `agy` plugin system, and benchmark agy models alongside Claude, OpenAI, and Gemini.
|
|
|
|
## Features
|
|
|
|
- **Automatic Setup**: Installs gstack skills directly into the Antigravity config directory via `./setup --host agy`.
|
|
- **Agy Plugin Compatibility**: Packages skills as a standard Agy plugin with a `plugin.json` manifest, automatically registered with `agy plugin install`.
|
|
- **Exclusion of Incompatible Skills**: Automatically filters out Claude-specific wrappers (like `gstack-codex`) from Agy generation.
|
|
- **Benchmark Integration**: Register Agy as a benchmark provider using `agy --print` to trace latency, quality, and tokens.
|
|
|
|
---
|
|
|
|
## Setup & Installation
|
|
|
|
To generate and install gstack skills into your local Antigravity environment:
|
|
|
|
```bash
|
|
./setup --host agy
|
|
```
|
|
|
|
### What Setup Does
|
|
|
|
1. **Precompile & Prepare**: Ensures the browse tool and other runtime dependencies are compiled.
|
|
2. **Generate Skills**: Runs `bun run gen:skill-docs --host agy` to generate Agy-compatible frontmatter.
|
|
3. **Initialize Plugin**: Creates the plugin directory structure under `.gemini/config/plugins/gstack`.
|
|
4. **Symlink/Copy Assets**: Places necessary executables (`bin`, `browse`, `review`, `qa`) into the plugin root.
|
|
5. **Register Plugin**: Invokes `agy plugin install` to import the gstack plugin into `~/.gemini/config/import_manifest.json`.
|
|
|
|
---
|
|
|
|
## Plugin Structure
|
|
|
|
When installed, the gstack plugin resides at:
|
|
`~/.gemini/config/plugins/gstack/`
|
|
|
|
The directory layout matches the standard Agy plugin structure:
|
|
|
|
```
|
|
~/.gemini/config/plugins/gstack/
|
|
├── plugin.json # Manifest declaring name, version, and license
|
|
├── skills/ # Generated Agy-compatible skills
|
|
│ ├── gstack/ # Root gstack skill (/gstack)
|
|
│ ├── gstack-qa/ # QA testing skill (/qa)
|
|
│ └── ...
|
|
├── bin/ # Shared executables and CLI tools
|
|
└── browse/ # Browse tool distribution files
|
|
```
|
|
|
|
---
|
|
|
|
## Benchmarking with Agy
|
|
|
|
Agy is registered as a model benchmark provider. You can execute prompts against Agy using the gstack benchmark runner.
|
|
|
|
### Pre-requisites
|
|
- The `agy` CLI must be installed and available in your `PATH`.
|
|
- Credentials must be configured in `~/.gemini/oauth_creds.json`.
|
|
|
|
### Run Benchmark
|
|
To run a dry run and check availability:
|
|
```bash
|
|
gstack-model-benchmark --models agy --dry-run
|
|
```
|
|
|
|
To execute a benchmark run:
|
|
```bash
|
|
gstack-model-benchmark --models agy --prompt "Explain quantum computing in one sentence."
|
|
```
|
|
|
|
The runner automatically passes `--dangerously-skip-permissions` to the CLI to run headless without hanging on interactive permission prompts.
|