google-antigravity/antigravity-cli

Purpose and Repository Shape

This repository is a public landing/documentation surface for Antigravity CLI, a terminal-based interface to Antigravity’s shared agent engine. It contains no CLI implementation, package manifest, build system, or runtime source; the product binary is installed remotely and invoked as agy. Primary user entry point: README.md.

Product Entry and Installation Boundary

Users install platform-specific scripts fetched from antigravity.google, then launch the externally supplied executable with agy. This repository documents, rather than owns, installation and execution:

• README.md

The installation scripts, executable distribution, updates, and core application lifecycle are external to this tree.

CLI Agent Runtime

The documented CLI runs as a low-overhead terminal/TUI agent for local and remote SSH workflows. Its advertised capabilities—codebase understanding, permissioned edits, command execution, multi-step reasoning, tool calling, and persistent history—belong to the shared Antigravity core agent engine, which is not present here:

• README.md

The key control boundary is user permission: the agent may edit files and execute commands only with user authorization.

Authentication and Session Flow

At startup or when authentication is needed, the installed CLI uses the system keyring for credentials. If no active session exists, it uses Google Sign-In: browser launch locally, or an authorization URL for SSH sessions. /logout clears saved credentials. Enterprise access additionally depends on GCP-project onboarding:

• README.md

Keyring storage, OAuth/sign-in implementation, SSH detection, and GCP integration are external services/runtime concerns.

Cross-Product Integration

Antigravity CLI and the Antigravity 2.0 GUI share an agent engine and synchronize preferences and permissions. CLI sessions can be exported to the GUI, establishing an interoperability boundary between terminal interaction and GUI-based continuation:

• README.md

Shell Customization Examples

The only executable artifacts in this repository are user-facing shell examples for integrating CLI state into terminal chrome:

• examples/statusline/statusline.sh

• examples/title/title.sh

Each example is documented alongside screenshots and is intended as optional shell-level presentation integration, not core CLI runtime behavior:

• examples/statusline/README.md

• examples/title/README.md

External Services and Governance

Material external dependencies are Antigravity’s hosted installer/distribution endpoints, Google authentication, system keyring facilities, optional GCP enterprise configuration, and Antigravity/Google data-governance services. Product, privacy, and risk disclosures are centralized in:

• README.md

• CHANGELOG.md