Project Spotlight

Paseo Antigravity CLI

A feature-complete provider plugin for the Paseo desktop agent environment that integrates Google's official Antigravity CLI (`agy`) over NDJSON streaming protocols.

View Repository Learn More

Native Stream-JSON

Directly spawns and supervises the official agy binary over NDJSON turns, streaming tool invocations, diffs, and responses without fragile proxy shims.

Autonomous Subagent Trees

Visualizes hierarchical subagent lifecycles, nested child sessions, and dedicated git worktree environments with full timeline fidelity.

Interactive Approvals

Implements Paseo plan review permissions, interactive question cards (ask_question), and background command lifecycle management.

What I Built

I engineered the Antigravity CLI provider plugin for Paseo, enabling developers to harness Google's agentic coding CLI within a modern desktop UI. The plugin bridges Antigravity's stream-json protocol with Paseo's reactive timeline, adding support for subagent orchestration, custom plan mode reviews, interactive multi-choice question prompts, slash commands, and multi-account quota monitoring.

NDJSON

Stream protocol

100%

Subagent tree tracking

Multi

Account & quota switcher

Key Features

  • Turn execution and event streaming powered by Google's official Antigravity CLI (agy).
  • Recursive subagent tree tracking with timeline inspection and dedicated child sessions.
  • Git worktree workspace isolation for parallel branch-based subagent tasks.
  • Custom Plan Mode workflow allowing users to review and approve proposed implementation plans.
  • Interactive question dialogues intercepting ask_question calls with single-select, multi-select, and custom write-in answers.
  • Background command monitoring that surfaces held steps from conversation transcripts during long commands.
  • Dynamic model discovery across Gemini tiers (High, Medium, Low) with automated cache invalidation.
  • Slash command and skill discovery from workspace .agents/skills and global Gemini skill paths.
  • Multi-account management UI with live per-account quota usage and seamless account switching.

Technical Architecture

The plugin is developed in TypeScript on Node.js 24, adhering to Paseo Provider Protocol v1. It manages the full lifecycle of agy subprocesses, serializing turns into NDJSON and streaming JSON events back to Paseo. Out-of-band events like question prompts and subagent spawns are tracked via conversation transcripts, while a dedicated React client screen provides account quota management.

Stack at a Glance

Runtime & Protocol

Node.js 24, TypeScript, Paseo Provider Protocol v1

Agent Core

Google Antigravity CLI (agy), NDJSON stream-json protocol, Child Process IPC

Client UI

Paseo Client Extension (React/TypeScript), Tailwind CSS

Developer Experience

Designed with resilience in mind, the plugin features robust process recovery, graceful signal termination, and comprehensive logging. Compatibility across npm and GitHub installation sources makes deploying and updating the plugin frictionless for Paseo users.

Outcome

Paseo Antigravity CLI bridges the gap between Google's CLI-based coding agent and desktop IDE ergonomics. It gives developers complete visual oversight of complex agent workflows, plan validations, and subagent collaboration.

Install the plugin via Paseo's plugin manager or visit the GitHub repository to view the full source code and documentation. https://github.com/lefos13/paseo-plugin-antigravity-cli.