Google DeepMind Platform•3 Min Read

The Fastest Way to Start a Project with Antigravity

Quick setup guide for the Antigravity CLI, workspace initialization, and automated workflows.

TGTech Geum Editorial
|July 17, 2026|Technical Setup Guide
Terminal window displaying the initialize screen of the Antigravity CLI agy in a modern developer workspace
info
Quick Update: Antigravity Visual IDE

Google DeepMind has launched the Antigravity Visual IDE alongside the agy CLI to support active visual pipelines.

Google Antigravity automates project setup, package installation, and containerized sandboxing using autonomous, safe agent loops.

Visual IDE vs. CLI Workflow

Manage your codebase directly via terminal commands or visually inside the multi-pane editor.

The visual panel layout of the Google Antigravity IDE showing workspace folders, agent logs, and live preview
Antigravity IDE Preview

terminalCLI Workflow (agy)

  • Best For: Headless scripting and CI/CD pipelines.
  • Interface: Clean terminal output with raw configs.
  • Speed: High-performance instant execution.

grid_viewVisual IDE Workflow

  • Best For: Active UI layout building and design reviews.
  • Interface: Built-in web visualizer and real-time execution logs.
  • Safety: Integrated visual diff authorization.

Try Antigravity Agents Live

Experience the Google Antigravity ecosystem directly from your browser. Click the tabs, simulate terminal commands, approve safety hooks, or preview files in the virtual IDE layout below.

Select Command to Run
$ curl -fsSL https://antigravity.google/cli/install.sh | bash

🔋 Fetching agy CLI distribution package...

🔑 Verifying cryptographic package signature... OK

📦 Unpacking binaries into /usr/local/bin/agy...

🎉 Success: agy v1.2.0 installed successfully!

Type "agy" in command line to launch.

$ agy create-project --spec "./project_specification.md"

🤖 Editor Agent initiated workspace routine...

📂 Reading spec markdown parameters...

🔨 Resolving Next.js compilation targets...

⚡ Created: src/app/page.tsx

⚡ Created: tailwind.config.ts

✨ Complete: Codebase verified (exit code 0)

$ agy run-tests --auto-fix
securityHuman-in-the-Loop Safety Authorization Required

Antigravity Editor Agent requests permission to run shell script: npm run dev.

✅ APPROVED: Executing "npm run dev"...

Ready on http://localhost:3000

Browser Agent verifying visual elements... Match 100%!

✨ Tests successfully passed.

❌ REJECTED: Safety approval denied by user.

Stopping execution loop immediately...

Editor Agent rolling back local file adjustments... OK

⚠️ Workspace safely restored to original state.

Agent Execution: ActiveInteractive Simulator
Workspace Files
Connected Agents
Terminal Agent (Idle)
Browser Agent (Active)
Editor Agent (Syncing)
src/app/page.tsx
export default function App() {
  return (
    <div className="min-h-screen flex items-center justify-center bg-gray-900">
      <h1 className="text-4xl font-bold text-white">
        Hello from Google Antigravity IDE!
      </h1>
    </div>
  );
}
src/app/globals.css
@tailwind base;
@tailwind components;
@tailwind utilities;

:root {
  --primary-color: #3b82f6;
  --agent-accent: #a855f7;
}
design.json
{
  "theme": "glassmorphism-dark",
  "borderRadius": "16px",
  "fontFamily": "Outfit, sans-serif",
  "enableAgentAutosave": true
}
syncBrowser Subagent testing components live in headless container...
98% Test Pass Rate

psychologyHow the Agent Architecture Works

Antigravity deploys specialized agents with built-in safety execution limits:

terminal
Terminal Agent (Max 5-min timeout)Runs system commands, resolves compilation issues, and handles localized testing loops.
language
Browser Subagent (Max 10-min timeout)Operates live test pages, clicks components, and takes visual verification video logs.
edit_note
Editor Agent (Max 3-min timeout)Executes file changes, fixes linter warnings, and maintains code design systems.

compare_arrowsAntigravity vs. Claude

Claude excels at reasoning through logic and generating beautiful source code segments. Antigravity acts as the execution partner that configures, runs, and tests the workspace. They work perfectly together—use Claude to write your schema blueprint, and Antigravity to run and verify it.

Design Your Workspace Manifest

Instead of copying and pasting static prompts, tell the Antigravity system exactly what you want using a workspace configuration file (spec.md). Choose your options below to see how the system manifest changes dynamically.

1. Project Framework
2. Safety Guardrail Policy
Generated Manifest: spec.mdAuto-updated

# Antigravity Next.js Workspace Specification

framework: nextjs-app-router

package_manager: npm

safety_level: strict (requires user input on all terminal executions)medium-auto (execute tests automatically, prompt on file deletion)

verify_url: http://localhost:3000


## Design Instructions

- Keep page.tsx static, export SEO metadata object.

- Install lucide-react components for icons.

# Antigravity Vite React Workspace Specification

framework: vite-react-spa

package_manager: yarn

safety_level: strict (requires user input on all terminal executions)medium-auto (execute tests automatically, prompt on file deletion)

verify_url: http://localhost:5173


## Design Instructions

- Build responsive router setup in App.tsx.

- Style with global glassmorphism tokens.

# Antigravity Node Express Specification

framework: express-backend

package_manager: pnpm

safety_level: strict (requires user input on all terminal executions)medium-auto (execute tests automatically, prompt on file deletion)

verify_url: http://localhost:8080/api/health


## Architecture Instructions

- Implement strict request body schema checks using Zod.

- Enable automated test suites in server.test.ts.

💡 Pro-Tip: The spec manifest is parsed automatically by the Terminal Agent. This guides the Editor and Browser Agents in real-time, removing the need for long, repetitive prompts.

1. Install the CLI (agy)

Choose your platform and run the setup script in your local console:

antigravity@console:~
Interactive installation via cURL wrapper
curl -fsSL https://antigravity.google/cli/install.sh | bash
💡 Environment: The installer registers local profiles automatically. Restart your shell session after running this command to activate the CLI.
PowerShell WebRequest execution script
irm https://antigravity.google/cli/install.ps1 | iex
💡 Tip: If execution is blocked, ensure your PowerShell process runs with remote-signed authorization settings.
Establish client OAuth token exchange credentials
agy init
💡 Auth: Prompts setup authorization in the default web browser. Once linked, the console gains workspace project write-access permissions.

2. Initialize a Project

Run the workspace generator in your project directory:

  1. 1

    Provide a Spec Plan

    Define framework routers, styling rules, and URLs in a local markdown file (e.g., spec.md), then run:

    agy initialize
    agy create-project --spec "./project_specification.md"
  2. 2

    Architecture Mapping

    Antigravity determines required packages, configures project parameters, and builds directory structures.

  3. 3

    Verification

    Review generated "Artifacts" details mapping file edits, dependencies, and configurations.

3. Safety Controls

Antigravity uses a strict human-in-the-loop authorization system. Before executing shell scripts, starting servers, or changing critical files, the CLI prompts for visual approval of changes.

Antigravity developer interface showing human-in-the-loop authorization prompt for executing local scripts
shieldVisual Safety Verification Dialog

Vibe Coding: Software Driven by Spec Manifests

Instead of managing syntax and compiler setup manually, vibe coders build features by updating a single spec.md manifest file.

auto_fix_highCoding by Pure Intent

Describe layout goals, design themes, and user stories. Antigravity translates this into file patches, database migrations, and clean route mapping.

eye_trackingVisual Validation

The Browser Subagent opens a sandbox window, verifies page loading, validates CSS structures, and records validation checks automatically.

rocket_launchExecution Steps

1. SetupThe Terminal Agent sets up configurations, resolves libraries, and handles local packages automatically.
2. Auto-DebugIf compilation fails, the Editor Agent reads compilation logs and edits files to fix compile errors.
3. ApprovalReview the changes, click Approve in the safety dialog, and let the code merge.

Frequently Asked Questions

Does Google Antigravity replace my preferred IDE?

expand_more

No. Antigravity runs as a CLI tool or task manager that works alongside VS Code, Neovim, or other editors. It handles package installation, boilerplates, and sandbox testing while you write logic.

Can I run Antigravity projects offline?

expand_more

While CLI checks and test executions run locally on your system, planning and code generation require internet access to DeepMind's Gemini models.

How does it connect to Google Cloud Platform?

expand_more

During setup, you associate your workspace with a local GCP Project ID. This enables agents to configure sandboxes and pull remote images under your billing control.

Is human-in-the-loop authorization optional?

expand_more

No. Safety is built-in. The CLI prompts for approval before running shell commands, editing directories, or installing external dependencies.

Explore More Content

Further Reading on Business Growth & Tech Systems

Deepen your expertise in search engine architecture, customer systems, and operational automation.

Browse All Blog Posts
call