@nghichcode/paseo_agy

An automated setup utility to bridge Google Antigravity 2.0 (agy CLI) with the Paseo agent orchestrator using the Agent Client Protocol (ACP) standard.

This tool copies the community ACP adapter source to your machine, compiles the platform-specific native binary, queries your local Gemini models, and registers the provider statically in Paseo's config.json.

Prerequisites

Before running the installer, ensure you have the following installed on your machine:

1. Google Antigravity 2.0 CLI (agy): Installed and authenticated (run agy in your terminal to verify).
2. Node.js & npm: To run the installer script.
3. Paseo: Installed (either the Desktop App or the CLI daemon).

Quick Start (No Install Required)

You can run the installer directly using npx:

npx @nghichcode/paseo_agy

What the installer does:

1. Copies the antigravity-acp bridge source code to ~/.gemini/antigravity/agy-acp.
2. Installs Bun and bridge dependencies.
3. Compiles the bridge into a fast, standalone native binary (e.g. agy-acp-darwin-arm64 on Apple Silicon).
4. Queries your system agy to discover available models.
5. Updates your ~/.paseo/config.json by adding the antigravity-acp provider and listing your models statically to avoid UI race conditions.

Remote, Mobile & Cross-Platform Control

Setting up this ACP bridge allows you to leverage various remote google antigravity 2 workflows. Once Google Antigravity is registered in Paseo over ACP, you can control and monitor your agents across different platforms:

• Mobile Remote Google Antigravity 2: Connect to your local agent sessions on the go. By running Paseo's web interfaces or remote companion apps (like AG Remote), you can orchestrate agents, review diffs, and approve command executions directly from your mobile device (iOS/Android).
• Desktop & VS Code Remote Sessions: Drive the Antigravity agent using remote code editors or IDEs that speak ACP (such as VS Code, JetBrains IDEs, and Zed Editor), enabling cross-platform remote development workflows.
• ACP UI Browser Client: Run tasks and prompts inside a lightweight browser tab on any device, bypassing the need for a full IDE environment for simple tasks.

Applying Changes

Once the installer completes successfully, restart your Paseo App or restart the daemon to apply changes:

paseo daemon stop && paseo daemon start

Local Development & Manual Installation

If you want to run the installer locally from source:

1. Clone the repository.
2. Install dependencies and run the setup script:

   npm run setup

License

MIT