When I wrote my complete Google Antigravity beginner setup guide, Antigravity was still a two-pane IDE experiment where Agent Manager lived inside a modified VS Code window. Since May 2026, Google has completely re-architected the platform into Google Antigravity 2.0, pushing rapid releases all the way up to v2.33.0 in November 2026.

If you opened Antigravity recently after watching Google’s “Google Antigravity, Redesigned” showcase or Julian Goldie’s “Antigravity Swarm 2.32.0” walkthrough and felt like half the buttons moved, you are not imagining things. The old Agent Manager graduated into a standalone desktop command center called the Antigravity App, workspaces turned into multi-folder Projects, Scheduled Tasks became Automations, and the single chat box gained /swarm, /run-workflow Python orchestration, a Knowledge Work layout, Gemini Live Voice Mode, a built-in browser, and SSH host connections.

Think of this post as the upgraded 2.0 edition of our earlier tutorial. I have spent the last six months building client Astro sites, SEO/GEO audit pipelines, and multi-agent automations inside the Antigravity 2.0 App every single day. Below is every architectural change, every panel, and every button in the new UI, backed by official screenshots and practical workflows you can copy today.

Part 1: Need Installation, OS Steps & Model Benchmarks? Google Antigravity Tutorial: Complete Setup Guide for Beginners If you have not installed Antigravity yet or want deep comparisons of Gemini 4 Carbon, Gemini 4 Hydrogen, Gemini 4 Argon, Orchestrator mode, and Windows/Mac/Linux login fixes, start with Part 1 first, then return here for the full 2.0 UI and Manager Mode upgrade. Read the Beginner Setup Guide →

Quick answer: Google Antigravity 2.0 separates the old Agent Manager into a standalone desktop app (now on v2.33.0) with multi-folder Projects, a dual Software Engineering / Knowledge Work layout toggle, a unified Overview and Side Panel, Gemini Live Voice Mode, /swarm multi-agent message boards, /run-workflow Python orchestration, and remote SSH execution. Keep using the separate Antigravity IDE only when you want manual line-by-line code editing. Last updated November 18, 2026.

Table of Contents

1. What Changed in Antigravity 2.0?2. Role Onboarding & Knowledge Work Layout
3. Left Sidebar & Conversation Canvas Tour4. Every Button in the Message Box Explained
5. Overview Panel, Side Panel & Built-in Browser6. Master Button & Shortcut Reference Table
7. Subagents, /swarm & Dynamic Workflows8. Automations, Remote Agents & SSH Hosts
9. Partner Marketplace & Setup Migration10. Changelog Timeline: v2.0 to v2.33.0
11. Key Takeaways & Commercial Next Steps12. Frequently Asked Questions

What Changed in Google Antigravity 2.0? (The Great Split)

Google Antigravity 2.0 turned the original Agent Manager view into an independent, agent-first desktop application (Antigravity App) that runs completely outside a traditional code editor. While the original November 2025 release tucked Agent Manager inside a VS Code fork, Antigravity 2.0 treats managing autonomous agents as the primary desktop experience across macOS, Windows, and Linux.

Google Antigravity 2.0 standalone desktop app showing the left sidebar, center conversation canvas, and right-hand side panel

Why did Google split the product in May 2026? Two practical bottlenecks pushed the redesign:

  1. Non-coding work outgrew the IDE shell. According to the official Google Antigravity team (November 9, 2026), tens of thousands of Googlers outside software engineering across product, design, sales, finance, legal, marketing, and operations now use Antigravity weekly. Forcing marketers, founders, and researchers to stare at Git branches and file trees slowed down adoption.
  2. One repo per chat was too rigid. Real builds touch a frontend folder, a backend repo, a local brand-guidelines folder, and a Google Drive brief at the same time. Antigravity 2.0 replaced single-folder Workspaces with multi-folder Projects.

The 5 Surfaces of Antigravity Today

You no longer rely on one monolithic editor. Instead, Google maintains five connected surfaces that share your rules, skills, plugins, and conversation history:

  • Antigravity App (v2.0 through v2.33.0): The standalone desktop command center (and web companion at antigravity.google.com) covered in this guide. This is where Manager Mode lives now.
  • Antigravity IDE: The standalone VS Code-based editor for hands-on coding, Antigravity Tab autocomplete, Supercomplete, and inline Cmd+I edits.
  • Antigravity CLI (agy): The fast terminal client (v1.2+ through v1.5+) supporting /swarm, /run-workflow, /btw, /voice live, and headless runs.
  • IDE Extensions (ACP): Official extensions bringing Antigravity agents into VS Code, Visual Studio, JetBrains IDEs, Android Studio, Zed, Xcode, and Eclipse.
  • Antigravity SDK: The Python SDK for programmatic agent leasing, custom tools, and lifecycle hooks.

Antigravity 1.x Agent Manager vs. Antigravity 2.0 Standalone App

DimensionAntigravity 1.x (Original Agent Manager)Antigravity 2.0 Standalone App (up to v2.33.0)
Primary HomeSecond mode inside a VS Code editor windowStandalone desktop Electron app + web app
Directory ModelSingle folder (“Workspace”) per conversationMulti-folder Projects + standalone No Project chats
Interface ModesDeveloper-only IDE stylingSoftware Engineering or simplified Knowledge Work layout
Multi-Agent ExecutionSingle agent + manual parallel chats (up to 5)Dynamic Subagents, /swarm message boards, and /run-workflow Python orchestration
Side Panel (Auxiliary Pane)Basic artifact previewUnified Overview panel + tabbed Side Panel (Review Git VCS, Built-in Browser, Terminals, PDFs, Jupyter .ipynb, /btw)
Voice InteractionBasic audio clip attachmentLive speech-to-text mic + two-way Gemini Live Voice Mode (v2.29.0+)
Scheduled TasksNone in v1.xDedicated Automations page (Scheduled, Always on, Paused) with model picker
Remote ExecutionLocal machine onlyRemote Control (phone/browser bridge), Remote Agents (cloud VMs), and SSH Hosts (v2.33.0)
Permissions & HooksGlobal presetPer-conversation composer permissions + JSON lifecycle hooks + terminal sandbox

Role-Based Onboarding and the Knowledge Work Layout

The Knowledge Work layout (shipped in v2.30.0 on November 9, 2026) strips away Git worktrees, terminal panes, and +/- diff counters so founders, marketers, designers, and analysts can run the exact same frontier agents in a clean workspace.

When you first sign in to a fresh Antigravity 2.0 install, onboarding no longer starts by asking you to pick a dark or light editor theme. Instead, it displays a Role Selection screen asking what best describes your work:

  • Software Engineering
  • Knowledge Work
  • Data & Analytics
  • Science
  • Design
Google Antigravity 2.0 role-based onboarding screen showing Software Engineering, Knowledge Work, Data and Analytics, Science, and Design options

Picking a role automatically sets your default Interface Layout, installs recommended starter plugins, and populates tailored prompt cards on the Home screen.

How to Switch Between Knowledge Work and Software Engineering

You are never locked into your onboarding choice. Switching takes two clicks and applies instantly without restarting the app:

  1. Press Cmd + , on macOS (Ctrl + , on Windows/Linux) or click Settings at the bottom-left of the sidebar.
  2. Open General > Interface Layout.
  3. Toggle between Software Engineering and Knowledge Work.
Antigravity 2.0 Settings General page showing the Interface Layout switch between Software Engineering and Knowledge Work

Note that Interface Layout switching is available on personal plans (Free, Google AI Plus, Google AI Pro, Google AI Ultra); business and enterprise managed accounts retain the Software Engineering workspace by default.

Side by side comparison of Antigravity 2.0 Software Engineering layout and simplified Knowledge Work layout

What Actually Changes Between the Two Layouts?

UI SurfaceSoftware Engineering LayoutKnowledge Work Layout (v2.30.0+)
Projects & GitShows Git branch pickers, Local vs. New Worktree mode, and IDE handoff buttonsCreates folder-backed projects directly without Git worktree prompts
Conversation ProgressExpandable tool groups, terminal command blocks, inline code diffs, and subagent cardsCollapses agent progress into a clean one-line status indicator that clears when finished
Permission PromptsDisplays raw terminal commands with syntax highlightingTranslates requested actions into plain-language summaries
Overview PanelOpen by default at top right; includes Review, Files, Terminal, ExtensionsStays tucked away until output exists; removes Review and Terminal rows; renames Files to Folders
Side Panel FocusDiffs, code viewer, terminals, browser, artifactsDocuments (PDF, Word, Excel, PowerPoint, Google Workspace), Artifacts, Links, Uploads, and Extensions
Customizations TabFull developer breakdown of plugins, rules, skills, hooks, and MCP serversHighlights installed Plugins upfront while skills, rules, and MCPs keep running quietly underneath

How I use both layouts: When I am building an Astro website or running technical SEO schema audits on a repo, I keep Software Engineering on so I can inspect every Git diff in the Review pane. When I am researching competitors, drafting Oh, So AI newsletter editions, or organizing strategy docs with Notion and Drive plugins, I flip to Knowledge Work in two seconds to remove visual noise.


Complete Visual Tour of the Left Sidebar and Conversation Canvas

In v2.29.0 and v2.30.0, Google unified the sidebar and title bar under one continuous background while lifting the center conversation and right side panel into crisp rounded cards (using the new Onyx theme and Google Sans font by default).

Here is every control along the left edge and center canvas of Manager Mode:

1. Top Search Bar & Unified Command Palette (Cmd+K)

In v2.28.2, Google deleted the old, clunky Conversation History full-page view. In its place, the top-left Search button and keyboard palette index the full text of every prompt and agent reply across your projects.

Antigravity 2.0 Command Palette showing instant search across conversations, project files, projects, and app commands

Use these four shortcuts to jump anywhere without touching your mouse:

  • Cmd + K (Ctrl + K on Windows/Linux): Search full text of Conversations (includes a filter/sort menu for Unread, Automations, Archived, Last Updated, or Last Prompt).
  • Cmd + P (Ctrl + P): Jump straight to Files inside your active project.
  • Cmd + Shift + K (Ctrl + Shift + K): Switch Projects.
  • Cmd + Shift + P (Ctrl + Shift + P): Run any App Command (such as Connect to SSH Host... or Mark All as Read).

2. Left Sidebar Navigation & Project Controls

Moving down the left sidebar, you have four primary navigation anchors plus your organized thread list:

  • New Conversation button: Opens a fresh session greeted at the top with your message box pinned to the bottom (v2.29.0+), plus starter prompt suggestions tied to your role.
  • Automations button: Replaces the old Scheduled Tasks tab (v2.21.1+) for cron jobs and one-shot background runs.
  • Customizations button: Opens your local Installed plugins, skills, rules, and MCP servers alongside the live partner Marketplace (v2.18.1+).
  • Settings button (bottom-left): Opens global Appearance, Shortcuts, Browser, Notifications, Account, and Permissions controls.

Inside the Projects list below those tabs:

  • Add Project (+) & Unified Wizard (v2.31.0+): Lets you pick This Computer, Remote (for cloud-hosted GitHub repos), or SSH Host… (v2.33.0) in one place. Multi-folder projects let an agent inspect both your website frontend and backend API folder simultaneously.
  • Display Options & Drag-and-Drop (v2.22.0 & v2.24.0): Drag conversations between sections, sort Pinned and project threads independently (Last Updated, Last Prompt, or Custom Order), or toggle Auto Pin to automatically pin threads you message.
  • Hover Status Badges (v2.23.0 & v2.28.0): Instead of a generic spinner, sidebar items now display distinct icons for Working, Background Command Running, Action Required (including when a subagent is waiting on approval!), and Unread, plus live GitHub PR status pills added in v2.33.0.
  • Keyboard Thread Management: Press Option + Cmd + P (Alt + Shift + P) to pin, Cmd + Option + A (Ctrl + Alt + A) to archive, and Option + Shift + Up/Down (Alt + Shift + Up/Down) to reorder chats.
  • Right-click / Overflow Project Menu: Includes Reveal in Finder (or Show in File Explorer), Project Settings (isolated permissions, sandbox toggles, and env-setup.sh), and Delete Project.

3. The Center Conversation Canvas: Bubbles, Navigator Rail & Themes

Inside the main chat card, three visual updates make long multi-hour builds vastly easier to scan:

  1. Right-Aligned Message Bubbles (v2.30.0): Your prompts now render as distinct chat bubbles on the right side of the canvas, visually separating human instructions from the agent’s full-width responses, tables, and artifacts.
  2. Conversation Navigator Rail (v2.28.1 & v2.29.0): Along the left edge of every conversation sits a slim vertical rail with one dot per turn. Hovering over a dot shows your exact prompt, a reply preview, and timestamp. Long threads collapse into labeled chapters with short AI-generated titles so you can jump back two hours without endless scrolling.
  3. Grouped "Worked for..." Action Rows (v2.21.1 & v2.30.0): Instead of flooding your chat with 40 separate file-read and terminal boxes, Antigravity collapses consecutive file reads, edits, commands, and subagent completion notices into one tidy summary row that auto-collapses once the agent finishes its reply.
  4. Expanded Themes & Typography (v2.21.1–v2.33.0): Under Settings > Appearance, you can now pick Onyx (default), Nord (v2.33.0), Everforest Light/Dark (v2.32.0), Gruvbox Material, or Legacy Light/Dark; switch fonts between Google Sans, Inter, and System UI; set interface font size to 12px, 14px, or 16px (v2.31.0); and set Conversation Width to Narrow, Default, Wide, or Fill (v2.29.0).

Every Button in the Bottom Message Box (Composer Bar) Explained

The bottom composer bar in Antigravity 2.0 packs context attachments, model routing, agent personas, per-chat security presets, and voice interaction into one compact footer, while docking active permission prompts directly above it.

Antigravity 2.0 bottom message box showing context attach button, model selector, and per-conversation permissions preset menu

Let’s walk through every button from left to right inside the composer:

1. The + (Add Context) Button

Clicking + opens the context menu for the current message. Between v2.16.0 and v2.33.0, Google removed almost every restrictive format gate:

  • Files & Folders: Add entire folders directly from the + menu (v2.23.0).
  • Any File Type (up to 20 MB) & Media (up to 200 MB): Attach .zip archives (the agent unpacks them automatically), design files, .amr voice recordings (v2.33.0), videos, or logs. Audio and video playback in the side panel supports files up to 200 MB (v2.33.0).
  • Native Microsoft Office Files (v2.16.0): Drag and drop Word (.docx), Excel (.xlsx), and PowerPoint (.pptx) files straight into the composer; Gemini models read them natively.
  • Mentions Shortcut: Trigger @ mentions directly from + without typing.

2. The @ Mention Menu & Inline Quote Button

Typing @ in the composer opens a fuzzy-search context picker so the agent starts from the exact file, rule, or past decision instead of burning tokens searching for it.

Antigravity 2.0 @ mention dropdown showing Rules, Conversation, Plugins, and fuzzy file search
  • @ Files and Folders: Fuzzy matching (@bkmk finds bookmarks.js). Pasting an exact path puts that file at the top of the list (v2.30.0).
  • @rules:: Injects any manual global or workspace rule (for example, a release checklist or ByHarshal’s SEO/GEO quality rubric) on demand.
  • @conversation:: Searches past conversation titles and messages (@conversation:rate limiter) so you can pass prior architecture decisions as a clickable chip into a new thread.
  • @ Plugins: Displays the plugin’s logo and hover description (v2.30.0).

Need to challenge or refine just two sentences from a long reply or a webpage? Highlight any text in a response, diff, file, artifact, or the built-in browser and click the floating Quote button (or press Cmd+L / Cmd+I on Mac, Ctrl+L / Ctrl+I on Windows/Linux). It drops the exact selection into your message box as a neat chip.

Inline Quote button popup when selecting text in an Antigravity 2.0 agent response

3. The / Slash Command Menu

Typing / pops open Antigravity’s built-in and plugin-provided slash commands (v2.18.1 added plugin badges and hover descriptions). Notice that rich formatting works right inside the message box too: in v2.30.0, typing - or 1. creates real bulleted and numbered lists (Shift+Enter for the next item, Tab to indent), and Cmd+Shift+V (Ctrl+Shift+V) pastes plain text.

4. The Model & Custom Agent Selector

In v2.29.0, Google merged the Custom Agent picker straight into the Model selector menu (and in v2.32.0, made the dropdown dynamically expand to fill your screen height with a Refresh button). From this single menu you can:

  • Choose Gemini 4 Carbon, Gemini 4 Hydrogen, Gemini 4 Argon, Orchestrator (Carbon), Orchestrator (Argon), Gemini 3.8 Flash, Claude Opus 5.5, or Claude Sonnet 5.5 (note: in v2.31.2 and v2.32.1, Google Cloud Application Default Credentials also expose Carbon and Hydrogen at low, medium, and high levels).
  • Adjust the reasoning effort level (Low, Medium, High, Extra).
  • Select any custom persona defined in .agents/ (which inherits customizations via inheritCustomizations).

5. The Per-Conversation Permissions Picker & Docked Cards

Look for the shield/permissions pill in the composer footer (v2.23.0). Under v2.30.0, changing the permission preset (Auto, Default, Request Review, Strict, or Proceed in Sandbox) applies only to the active conversation, so running an exploratory build in Auto does not weaken guardrails on a sensitive production repo in another tab.

Equally helpful for daily flow: v2.26.0 changed permission requests and multi-question /grill-me cards so they dock neatly above the message box instead of hiding it. You can keep drafting or queuing your next prompt (or even press Cmd+Arrow / bind a custom Submit Prompt key in v2.32.0) while a request waits. Plus, in v2.33.0, messages sent immediately while the agent is still typing stay steady and calm without pulsing or jumping the layout above them.

6. Project / Git Worktree Selector (Software Engineering Layout)

When inside a project in Software Engineering layout (v2.29.0+), a single unified selector right by the composer lets you pick Local (edit active folders directly) or New Worktree (spin up an isolated Git branch checkout so parallel agents never collide on files), search branches when a repo has over 15 branches, or jump into remote GitHub repos.

7. Dictation Microphone vs. Gemini Live Voice Mode Button

There are now two distinct voice buttons in the bottom-right corner of the message box (v2.29.0+):

Empty Antigravity 2.0 message box showing the Gemini Live Voice Mode sound-bars button next to the live dictation microphone
  • Dictation Microphone Icon (Ctrl+M): Transcribes what you say live into text inside the message box so you can edit or verify technical filenames before hitting Enter. (For why speaking prompts at 130+ WPM beats typing at 40 WPM, read my breakdown on voice dictation for vibe coding.)
  • Start Voice Mode Button (Round Sound-Bars Icon): Appears automatically when the message box is empty (or next to the Stop button while the agent runs). Powered by Gemini Live, clicking it opens a two-way spoken call inside your conversation.
Active Antigravity 2.0 Voice Mode dock with nine voice choices, playback speed toggle, and live spoken summary

During a Voice Mode call, you can steer a running task out loud, answer multi-choice question cards and permission approvals by voice without touching the mouse (v2.31.0), pick from 9 voices, adjust speaking speed between 0.75x and 2x, and get a short written call summary card when you hang up (v2.31.0).


The Top-Right Overview Panel and Side Panel (Auxiliary Pane)

The right half of Antigravity 2.0 houses two tightly linked surfaces introduced and refined between v2.11 and v2.33.0: the Overview Panel (your conversation table of contents) and the Side Panel (where diffs, files, terminals, subagents, and live web previews open as tabs).

1. The Top-Right Overview Panel (Cmd+Option+O)

Every conversation now shows an Overview card in the top-right corner (Toggle Overview Panel button, or Cmd+Option+O on Mac / Ctrl+Alt+O on Windows/Linux). When your window gets narrow, it collapses cleanly and slides over the chat on demand.

Antigravity 2.0 top-right Overview panel listing changed line counts, Review row, Subagents, Background Tasks, Artifacts, and Modified Files

Inside the Overview panel:

  • Top Action Rows: One-click openers for Review (showing live +added / -deleted Git line totals from v2.29.0), Files (renamed Folders in Knowledge Work), Terminal (click repeatedly to launch multiple tabs), and Extensions (plugin UI panes).
  • Pull Requests Section (v2.33.0): Displays live GitHub pull request status pills and hover cards linked from your thread.
  • Dynamic Output Sections: Automatically groups Subagents, Background Tasks (with hover Cancel Task buttons), Goals, Documents (PDFs, Office files, Google Workspace links), Artifacts (Implementation Plans, Walkthroughs), Links, Modified Files, and Uploads. Click the three-dot Customize Sections button to pin or hide any section globally (v2.24.0).

2. The Tabbed Side Panel (Cmd+Shift+M & Cmd+Shift+T)

Clicking any item in Overview opens it inside a tab in the Side Panel next to your chat. Two shortcuts here save constant mouse travel:

  • Maximize Side Panel (Cmd+Shift+M / Ctrl+Shift+M): Slides the panel over the conversation at full width instead of squeezing your text (v2.24.0).
  • Reopen Closed Tab (Cmd+Shift+T / Ctrl+Shift+T): Restores a closed file, browser tab, or diff at its exact scroll position (v2.28.0).
  • New Tab Page (v2.29.0): Clicking + in the side panel tab strip opens a clean New Tab page where you can enter any URL, search Google, or drag links straight from the chat.
Antigravity 2.0 Side Panel New Tab view with built-in browser address bar, bookmarks, and multi-tab workspace

3. The Review & Git VCS Pane

One of the best upgrades in Antigravity 2.0 is never having to bounce back to VS Code or Sourcetree just to verify what an agent (or an external script) changed.

Antigravity 2.0 Review changes side panel showing file status badges, word-level diff highlighting, inline comments, and Git commit panel

Key controls inside the Review tab:

  • Three-Way Filter Dropdown: Switch between Uncommitted (staged/unstaged working tree), Branch (every change since origin/main), and Agent Edits (only files touched by this conversation), or click Review on a single chat card (2 files changed) to filter down to one turn.
  • Word & Character Diffs (v2.28.0) + Image Diffs (v2.7.1): Highlights exact modified tokens inside lines, preserves syntax colors, and renders side-by-side visual comparisons for changed images and SVGs.
  • View Toggles (⋮ Menu): Toggle View Split Diff vs. View Stacked Diff, Hide Whitespace Changes, Collapse All, or Cmd+F across every diff (v2.11+ fixed search across collapsed files).
  • Line-by-Line Feedback & Git Commit: Hover any line to click + (Add inline comment), type a correction, and send targeted review notes back to the agent. When satisfied, stage files, write a commit message, and commit right inside the pane.

4. The Built-in Browser Tab (v2.28.0 to v2.33.0)

Instead of kicking every localhost link or web research source to an external Chrome window, Antigravity 2.0 embeds a full built-in browser inside a Side Panel tab (v2.28.0):

  • Auto-Widening Layout: Automatically widens the side panel when a web tab opens so sites render in desktop view rather than cramped mobile columns.
  • Security & Download Gate (v2.28.0, v2.31.0, v2.32.0): Shows TLS certificate status, lets you clear per-site cookies from the address bar, isolates cross-site iframes as signed-out and hidden from agent screenshots (v2.32.0), and pauses any browser-agent download until you explicitly click Approve (v2.31.0).
  • In-Page Find & Right-Click Quote (v2.30.0 & v2.33.0): Press Cmd+F (Ctrl+F) inside the browser toolbar, or right-click highlighted webpage text to Comment or Quote straight into your prompt.
  • Open Behavior: Cmd+Click (or middle-click) opens links in a background tab; Shift+Click opens in your external system browser.

5. Built-in Viewers: PDF, Jupyter Notebooks, Media & /btw Side Questions

  • Native Jupyter Notebook Viewer (v2.29.0): Opens .ipynb files directly inside the Side Panel with rendered code cells, Markdown, tables, and chart outputs.
  • Fast PDF Viewer + Export Markdown as PDF (v2.19.1, v2.28.0, v2.33.0): Reads local and artifact PDFs natively (with deferred text-layer loading in v2.33.0 so huge spec docs scroll without lag), and lets you export any rendered Markdown artifact or file as a clean PDF from its overflow menu.
  • Full-Screen Media Viewer (v2.23.0 & v2.24.0): Click any image, audio file, or video to zoom/pan, hold Space for 2x playback speed, or press , and . to step frame-by-frame.
  • Multi-Turn /btw Side Question Tab (v2.32.2 & v2.33.0): Need to check where a helper function lives while your main agent is in the middle of a 10-minute build? Type /btw Where is our schema helper defined? and hit Enter. It forks your context into a dedicated Side Question tab in the side panel with read-only file and search tools, answers without touching your main thread’s context window, supports multi-turn follow-ups (v2.32.2), and offers an Insert into main conversation button (v2.33.0).

Master Table of Antigravity 2.0 UI Buttons and Shortcuts

Bookmark this table as your quick visual map for every major UI button and keyboard shortcut in the Antigravity 2.0 App (updated through v2.33.0).

UI Button / ControlLocation in UImacOS ShortcutWindows / Linux ShortcutWhat It Does
Search ConversationsTop-left sidebarCmd + KCtrl + KFull-text search across all chats, prompts, and replies (v2.28.2+)
Search Files / Switch ProjectCommand PaletteCmd + P / Cmd+Shift+KCtrl + P / Ctrl+Shift+KJump to project files or switch multi-folder Projects
Command PaletteGlobalCmd + Shift + PCtrl + Shift + PRun any app action (SSH Host, Mark All Read, Reload)
New ConversationLeft sidebar topCmd + NCtrl + NStart a new chat in active project or standalone mode
Toggle SidebarTop-left cornerCmd + BCtrl + BCollapse or expand the Projects & Conversations sidebar
Pin / Archive ConversationSidebar hover menuOpt+Cmd+P / Cmd+Opt+AAlt+Shift+P / Ctrl+Alt+APin important builds or archive finished threads
Reorder ConversationSidebarOpt + Shift + Up/DownAlt + Shift + Up/DownMove active conversation up/down or into Pinned section
Toggle Overview PanelTop-right of chatCmd + Option + OCtrl + Alt + OShow/hide changed lines, Artifacts, Subagents, and PRs
Maximize Side PanelSide panel top barCmd + Shift + MCtrl + Shift + MExpand Review, Diff, Browser, or Preview full-width over chat
Reopen Closed Panel TabSide panel tab barCmd + Shift + TCtrl + Shift + TRestore closed file, diff, or browser tab with scroll state
+ Add ContextComposer bottom-leftClick + buttonClick + buttonAttach files (20 MB), media (200 MB), folders, .zip, Office docs
@ Mention / QuoteComposer / text highlightCmd + L or Cmd + ICtrl + L or Ctrl + ITag @Files, @rules:, @conversation:, @Plugins, or quote text
/ Slash CommandsComposer inputType /Type /Invoke /swarm, /run-workflow, /plan, /btw, /grill-me, /compact
Model & Agent PickerComposer footerClick model dropdownClick model dropdownPick Gemini 4 Carbon/Hydrogen/Argon, Orchestrator, Claude 5.5, or Custom Agent
Permissions Preset PillComposer footerClick shield menuClick shield menuSet Auto, Default, Request Review, Strict, or Sandbox per conversation
Voice Dictation MicComposer bottom-rightCtrl + MCtrl + MLive speech-to-text directly into the message box
Start Voice ModeComposer (when empty)Click waveform iconClick waveform iconStart real-time two-way Gemini Live voice call with agent (v2.29.0+)
Settings & Layout SwitchSidebar bottom-leftCmd + ,Ctrl + ,Switch Knowledge Work vs. Software Engineering, themes, and shortcuts
Paste Plain TextComposer inputCmd + Shift + VCtrl + Shift + VPaste unformatted text without breaking prompt chips (v2.24.0+)
Cancel Active TurnComposer / StopCmd + D / EscCtrl + D / EscInterrupt a running agent turn cleanly (v2.33.0 fixed Ctrl+D on Win/Linux)

Multi-Agent Orchestration: Subagents, /swarm, and Dynamic Workflows

Antigravity 2.0 gives you four distinct ways to split work across multiple agents: Orchestrator Mode, Dynamic Subagents, /swarm (launched in v2.31.0), and Dynamic Workflows (/run-workflow, launched in v2.32.0). Choosing the right one determines both your speed and how fast you burn plan quota.

1. Dynamic Subagents & Live Status Cards (v2.16.0 to v2.33.0)

Whenever your main agent delegates a self-contained investigation or parallel file edit, it spins up a Dynamic Subagent with a clean, isolated context window so test logs and searches do not bloat your main chat.

  • Workspace Isolation: Subagents can share your working folder (inherit), clone an isolated Git branch (branch), or share underlying repo storage (share).
  • Live Cards & Direct Messaging: Subagents appear as one-line live cards (v2.16.0 & v2.23.0). You can hover to stop a runaway subagent, click to open its full conversation in the Side Panel, or type directly in the subagent’s own message box (v2.19.1) to steer it without going through the main agent.

2. /swarm: Real-Time AI Agent Teams on a Shared Board (v2.31.0 & v2.33.0)

Featured in Julian Goldie’s “Antigravity Swarm 2.32.0” demo and officially added in v2.31.0 (then expanded to business and enterprise accounts in v2.33.0), /swarm turns your conversation into a Coordinator managing a live team of named specialists.

Google Antigravity 2.0 Swarm Shared Message Board showing Coordinator, named Workers, and Verifier posts

Here is what happens the moment you run /swarm <your task> (available on Google AI Pro and Ultra plans):

  1. The Coordinator plans and names workers: It splits the task into non-overlapping pieces (@ui, @api, @seo, or numbered pools like @fix-1 to @fix-4) and posts public briefs so every agent sees who owns which file.
  2. A @verifier checks every 2 to 4 workers: Verifiers read diffs, run tests or browser checks, and post bug reports directly back to the worker that wrote the code.
  3. A @monitor breaks stalls & idle agents sleep for free: Waiting agents cost zero tokens until another member @mentions them. Big swarms can even split into #channels to avoid waking unrelated agents.
  4. Live Swarm Board & Graph Tab: Open the Swarm pane from the coordinator’s reply to watch the board stream in real time, or click the Graph tab to inspect dependencies and live states (working, waiting, done).
Antigravity 2.0 Swarm Graph tab visualizing active coordinator, worker, and verifier relationships

Try this copy-paste /swarm prompt for building a new multi-section landing page cleanly without file collisions:

/swarm Prompt (Parallel Landing Page + Verification)
/swarm Build the new B2B Services landing page in Astro with strict file ownership:
- @layout owns src/pages/services/ai-workflows.astro and shared styles
- @schema owns JSON-LD Service + FAQPage structured data and meta tags
- @copy owns scannable section copy and comparison table data
- @verifier runs npm run build, opens the built-in browser at desktop and mobile widths, and reports any broken links or layout overflow back to the file owner before reporting done.

3. Dynamic Workflows (/run-workflow, Added in v2.32.0)

While /swarm lets agents talk dynamically on a board, Dynamic Workflows (/run-workflow) gives you predictable, Python-scripted orchestration using a Python runtime bundled inside Antigravity (v2.32.0).

When you type /run-workflow <task>, the main agent writes a clean Python orchestration script using primitives like phase(), agent(), parallel(), pipeline(), call_tool(), and trajectory(), then pauses to let you review and Approve the script before running it in the background.

Antigravity 2.0 Dynamic Workflows script approval card showing Python parallel and pipeline code before execution

As the workflow executes, a clean live card groups every spawned agent under named phases (phase("Discover"), phase("Audit")), each returning schema-validated JSON via finish so file reads never pollute your primary conversation. You can even tell the agent to save a working script in your project and reuse it anytime.

Antigravity 2.0 Dynamic Workflows live progress card showing named phases and parallel agent cards

Here is what an actual /run-workflow Python script looks like when fanning out an on-page SEO and GEO audit across a folder of pages:

Example Dynamic Workflow Script (/run-workflow)
phase("Discover Pages")
pages = await agent(
    "List all .astro page paths under src/pages/services/.",
    schema={"type": "array", "items": {"type": "string"}},
    role="Page Discovery",
    model="flash",
)

phase(“Parallel SEO & GEO Audit”) audits = await parallel( pages, lambda p: agent( f”Audit {p} for missing JSON-LD schema, H1 structure, and meta description length.”, schema={“type”: “object”, “properties”: {“path”: {“type”: “string”}, “issues”: {“type”: “array”, “items”: {“type”: “string”}}}}, role=f”Audit {p}”, model=“flash”, ), )

for item in audits: log(item)

/swarm vs. /run-workflow vs. Orchestrator vs. Subagents: Which Should You Use?

This is the exact decision framework I use on client builds (and the core question covered in the Swarm 2.32.0 walkthrough):

Orchestration ModeControl StyleCommunicationQuota ImpactBest Use Case
Orchestrator (Carbon / Argon)Single-thread auto-handoff (heavy planner + Hydrogen builder)Automatic within one conversationLower (~24% less quota and ~19% faster than Carbon alone, per Google)Daily multi-file features, auth changes, or refactors that might hit mid-task snags
Dynamic SubagentsAgent-initiated background delegationReports back only to parent agentLow to MediumOffloading isolated research, test runs, or independent file checks
/swarm (Pro / Ultra)Emergent team coordination (Coordinator, Workers, Verifier)Public shared message board (@name, #channels)High (every worker is a full agent session)Full-feature builds, landing pages, or multi-package work needing interactive peer review
/run-workflow (Pro / Ultra)Deterministic Python script (parallel(), pipeline(), phase())Structured JSON returns via finish schemaControlled (you pick "flash" / "flash_lite" per step)Repeatable audits, batch reviews across 10+ files, or staged test-then-fix pipelines

Two other useful slash commands round out this planning toolkit:

  • /plan (v2.17.0): Forces a research and interview phase producing an editable Implementation Plan artifact before touching code (governed by Settings > Plan Review Policy).
  • /grill-me: Interviews you one multiple-choice question at a time (highlighting a recommended option first) to nail down edge cases before anyone writes a line of code.
  • /goal: Runs autonomously until every acceptance check passes without asking for intermediate hand-holding.
  • /compact (v2.24.0): Summarizes a massive conversation so far and frees up context room so you can keep going without starting over.
  • /learn: Extracts corrections and preferences from your session and writes them permanently into your Rules or Skills files.

Automations, Remote Control, Remote Agents, and SSH Connections

Antigravity 2.0 breaks the old rule that you must sit in front of a single laptop with an open chat tab. Between v2.0 and v2.33.0, Google added four ways to run agents hands-free or from anywhere.

1. The Redesigned Automations Page (/schedule & /automation)

Originally launched as Scheduled Tasks in Antigravity 2.0 and rebuilt as Automations in v2.21.1 and v2.29.0, this sidebar tab turns prompts into recurring cron jobs or one-off timers.

Antigravity 2.0 Automations and Scheduled Tasks configuration screen with cron schedules and Run Now controls

Key upgrades you will notice inside Automations:

  • Organized Status Queues (v2.29.0): Cleanly separates jobs into Scheduled, Always on, and Paused lists with exact Next run and Last run timestamps.
  • Model Selector per Automation (v2.24.0): Pick Flash Lite, Flash, or Pro individually for each scheduled job so lightweight daily checks do not burn Pro quota.
  • Run Now & Create with Prompt (v2.21.1): Test any cron job immediately with one click, or click Create with Prompt to let Antigravity write the cron expression and instructions for you.

2. Local App vs. Remote Control vs. Remote Agents vs. Connect Over SSH (v2.33.0)

One of the biggest releases of the year landed on November 17, 2026 (v2.33.0): native SSH Host connections. Together with Remote Control and Remote Agents, you now have four distinct execution environments:

ModeWhere the Agent RunsMachine RequirementBest ForAvailability
Local Desktop AppYour Mac, Windows, or Linux computerMust stay powered onDaily client builds, local dev servers, UI previewsAll plans
Remote Control (antigravity.google.com)Your local desktop or agy CLI daemon, controlled from any browserHost machine must stay awake and onlineMonitoring long builds from your phone with mobile push alertsAll plans (enable in Settings)
Remote Agents (v2.29.0–v2.30.0)Isolated Google-managed cloud VMs (antigravity.google.com/remote)Your laptop can sleep or close completelyCloud GitHub PR tasks, Google Drive workflows, mobile-first startsGoogle AI Pro & Ultra (personal accounts)
SSH Host (v2.33.0, New)Remote 64-bit Linux machine via ~/.ssh/configRemote Linux server onlineHeavy server builds, Linux worktrees, agents that keep running after window closesAntigravity App v2.33.0+

To try SSH in v2.33.0, open the project menu (SSH Host...), click the sidebar connector, or press Cmd+Shift+P and run Connect to SSH Host.... Antigravity installs its remote server over OpenSSH automatically and executes projects, Git worktrees, and terminals straight on your Linux box.


Customizations, Partner Marketplace, and 1-Prompt Migration

In v2.18.1 and v2.28.2, Antigravity replaced manual JSON MCP editing with a full Customizations hub and Partner Plugin Marketplace, plus a v2.30.0 migration skill that imports setups from Claude Code, Cursor, or Codex automatically.

Antigravity 2.0 Customizations Marketplace showing partner plugins across Developer Tools, Google Workspace, Design, and Cloud Hosting

Highlights inside Customizations:

  • Curated Partner Shelves (v2.28.2 & v2.33.0): Install one-click plugins (bundling MCP servers, skills, rules, and custom UI panels) from Cloudflare, Vercel, Netlify, Railway, Figma, Canva, Linear, Notion, Stripe, Supabase, MongoDB, Sentry, Datadog, SonarQube, Tavily, Grafana Cloud, Atlassian, and Google Workspace.
  • In-App OAuth & Multi-Account Switching: Adding a plugin walks straight into browser sign-in, displays an Accounts tab for swapping personal vs. work profiles, and offers Fix with Agent (v2.23.0) whenever a local MCP binary is missing.
  • Split-View UI Extensions (v2.22.0 & v2.31.0): Partner plugins can open rich interactive dashboards in the Side Panel or share a split view right beside your conversation.
  • Token Usage Budget Bars (v2.18.1): Inspect exactly how many tokens your active rules and skills consume, with warnings if any customization exceeds budget.

How to Import Your Claude Code, Cursor, or Codex Setup in One Prompt (v2.30.0+)

Instead of manually copying .cursorrules, CLAUDE.md, or .mcp.json files one by one, run this prompt in a fresh Antigravity 2.0 conversation (it triggers the built-in migrate-agent-settings skill):

Migration Prompt (v2.30.0+)
Import my existing Claude Code and Cursor setup (MCP servers, custom skills, slash commands, subagents, and rule files) into a clean personal Antigravity plugin, and list anything that needs an OAuth sign-in or API key check.

Complete Antigravity 2.0 Changelog Cheat Sheet (v2.0 to v2.33.0)

Because Antigravity ships new desktop releases every few days, here is the official timeline of the biggest Manager Mode and UI changes between May 2026 and November 17, 2026 (verified against the official Antigravity Changelog):

VersionRelease DateKey UI, Manager Mode & Platform Changes
v2.0.1May 19, 2026Standalone Antigravity 2.0 desktop app launches; replaces single Workspaces with multi-folder Projects; adds Dynamic Subagents, JSON hooks, Scheduled Tasks, /goal, /grill-me, /schedule, /browser
v2.2.1Jun 25, 2026Built-in antigravity-guide skill, audio file playback in viewer, Conversation Width setting (Narrow/Default/Wide)
v2.7.1 – v2.8.0Aug 11–12, 2026Side-by-side image & SVG diffs, Last Prompt sorting, persistent collapsed/expanded sidebar folders
v2.11 – v2.15Aug–Sep 2026Git VCS controls in Side Panel (Agent Edits/Uncommitted/Branch), Terminal tab, Windows sandbox, keyboard chat navigation
v2.16.0 – v2.17.0Sep 22, 2026Native Microsoft Office file drops (.docx, .xlsx, .pptx), live subagent status cards, WSL integration on Windows, /plan + Plan Review Policy, Reveal in Finder
v2.18.1 – v2.19.1Sep 28–30, 2026Plugin Marketplace inside Customizations, token budget breakdown for rules, direct messaging inside subagent cards, Export Markdown as PDF, conversation-only undo
v2.21.1 – v2.22.0Oct 7–8, 2026Cmd+K full-text search, Scheduled Tasks renamed Automations (Run Now, Create with Prompt), grouped agent action rows, sidebar drag-and-drop, UI plugin side-panel views
v2.23.0 – v2.24.0Oct 12–15, 2026Per-conversation composer Permissions picker, .zip & folder uploads, full-screen media viewer, redesigned Overview & Side Panel, /compact, Cmd+Shift+M maximize, Gemini 4 Argon
v2.26.0Oct 22, 2026Question cards & permission prompts dock above the message box, Notifications sound/volume settings
v2.28.0 – v2.28.2Oct 27–29, 2026Built-in Browser, built-in PDF viewer, 20 MB any-file uploads, word-level diffs, Conversation Navigator rail, partner plugins (Figma, Linear, Notion, Stripe), removed old History page
v2.29.0Nov 3, 2026Voice Mode (Gemini Live) & Remote Agents begin rollout, Onyx default theme + Google Sans, redesigned Home & Automations pages, Jupyter .ipynb viewer, custom shortcuts, AI-titled chapter cards
v2.30.0Nov 9, 2026Knowledge Work vs. Software Engineering layout switch, role-based onboarding, right-aligned chat bubbles, per-chat permissions, 1-prompt migration from Claude Code/Cursor/Codex
v2.31.0Nov 9–10, 2026/swarm multi-agent message boards, font size selector (12/14/16px), split-view plugin panels, mandatory approval for browser-agent downloads, voice call summaries, Gemini 4 Carbon
v2.32.0 – v2.32.2Nov 12–16, 2026Gemini 4 Hydrogen & Orchestrator mode, Dynamic Workflows (/run-workflow) with bundled Python runtime, Everforest themes, multi-turn /btw Side Question tabs with read-only tools
v2.33.0 (Latest)Nov 17, 2026Connect over SSH to 64-bit Linux hosts, live GitHub PR status pills & Overview section, Cmd+F inside built-in browser, /btw Insert into main conversation, /swarm & UI plugins for business/enterprise, Nord dark theme, 200 MB media playback, Cloudflare/Grafana/Tavily marketplace plugins

Key Takeaways

  • Manager Mode is now its own app: Antigravity 2.0 unbundled Agent Manager from the IDE into a standalone command center (now at v2.33.0) designed around multi-folder Projects rather than single codebases.
  • Two interfaces, one brain: Switch between Software Engineering and Knowledge Work under Settings > General > Interface Layout (Cmd+,) whenever you jump between client codebases and research, writing, or marketing work.
  • Every control sits closer to your flow: Use Cmd+K for instant full-text search (replacing the old History page), Cmd+Option+O for the Overview panel, Cmd+Shift+M to maximize diffs or the Built-in Browser, and the composer’s per-conversation permissions pill so exploratory threads never weaken production repo guardrails.
  • Pick the right multi-agent tool: Use Orchestrator (Carbon/Argon) for everyday multi-file builds, Dynamic Subagents for isolated side work, /swarm when independent specialists and a @verifier should collaborate on a board, and /run-workflow when you want repeatable Python-scripted parallel phases.
  • Go hands-free or remote: Combine Gemini Live Voice Mode (sound-bars icon), multi-turn /btw Side Questions, Automations, Remote Agents, and SSH Host connections (v2.33.0) so builds keep moving even when you step away from your desk.

If you are still setting up Antigravity on your machine or troubleshooting rate limits and path issues, keep these two guides bookmarked:

Foundation Guide (Part 1) Google Antigravity Tutorial: Complete Setup Guide for Beginners OS installation steps for Mac, Windows, and Linux, plus full specifications and benchmarks for Gemini 4 Carbon, Hydrogen, Argon, Orchestrator mode, and Claude 5.5. Read the Beginner Setup Guide → Resource Vault Google Antigravity Errors: The Complete Troubleshooting Guide Instant fixes for workspace path conflicts, terminal timeouts, HTTP 429 rate limits, and authentication loops. View troubleshooting guide →

Want this level of orchestration inside your own agency or company? Antigravity 2.0 is only half the story. The real speed comes from wiring your Notion, Google Drive, GitHub, and SOPs into documented, reliable pipelines your team owns. See how our 2-week AI workflow consultancy works, or book a free 30-minute discovery call if you want help building custom AI workflows or a fast Astro website in 7 to 14 days.


Frequently Asked Questions

What is the biggest change between Google Antigravity 1.x and Antigravity 2.0?

Google separated the old Agent Manager out of the VS Code-based editor into a standalone desktop command center called the Antigravity App (Antigravity 2.0). Instead of tying every chat to one code repository, Antigravity 2.0 introduces multi-folder Projects, a redesigned Overview and Side Panel, Dynamic Subagents, /swarm, Dynamic Workflows (/run-workflow), Voice Mode, and a dedicated Knowledge Work layout.

Did Google remove the Antigravity IDE in version 2.0?

No. The standalone Antigravity 2.0 App handles agent management and orchestration, while Antigravity IDE remains available for developers who prefer an in-editor coding layout. Google also offers the Antigravity CLI (agy), extensions for external IDEs (VS Code, Visual Studio, JetBrains, Android Studio, Zed, Xcode, and Eclipse), and the Antigravity Python SDK.

What is the Knowledge Work layout in Antigravity 2.0?

Introduced in v2.30.0 (November 9, 2026), the Knowledge Work interface layout simplifies Antigravity for research, writing, marketing, design, and operations. Located under Settings > General > Interface Layout, it hides Git worktree prompts, code diff line counts, and terminal tabs while collapsing agent steps into a single progress line and renaming Files to Folders.

What is the difference between /swarm and /run-workflow in Google Antigravity?

Use /swarm when a task benefits from autonomous peer-to-peer coordination: named workers (such as @ui and @api) plus a @verifier talk on a shared message board and fix issues dynamically. Use /run-workflow (Dynamic Workflows, added in v2.32.0) when you want deterministic, Python-scripted control flow using parallel() and pipeline() phases that return structured JSON outputs without cluttering your main chat.

How does /btw work in Antigravity 2.32.2 and v2.33.0?

Typing /btw followed by a question opens a dedicated Side Question tab in the side panel without pausing your running agent. As of v2.32.2, Side Question tabs support multi-turn follow-ups with read-only access to read files and search your workspace, and v2.33.0 adds an Insert into main conversation button.

What is the difference between Voice Dictation and Voice Mode in Antigravity 2.0?

Voice Dictation (the microphone button or Ctrl+M) transcribes your speech directly into the message box so you can review and edit text before sending. Voice Mode (the sound-bar button in an empty message box, powered by Gemini Live in v2.29.0+) opens a live two-way spoken call where you assign tasks, answer permission prompts out loud, and hear the agent respond across 9 selectable voices.

Where did Conversation History and Scheduled Tasks go in Antigravity 2.0?

In v2.21.1, Scheduled Tasks was renamed to Automations and gained Scheduled, Always on, and Paused views plus a Create with Prompt builder. In v2.28.2, Google removed the separate Conversation History page and replaced it with unified full-text search via the top-left Search button (Cmd+K / Ctrl+K) and sidebar filters for Unread, Automations, and Archived threads.

What is the difference between Remote Control, Remote Agents, and SSH Host connections?

Remote Control bridges a web browser on your phone or laptop to an active Antigravity session running on your own powered-on computer. Remote Agents (v2.29.0+, for Google AI Pro and Ultra personal accounts) run cloud-hosted sessions on Google-managed infrastructure even if your laptop sleeps. SSH Host connections (added in v2.33.0) let the desktop Antigravity App install its remote server over OpenSSH on any 64-bit Linux machine in your ~/.ssh/config.

Can I import my existing Claude Code or Cursor setup into Antigravity 2.0?

Yes. Starting in v2.30.0, Antigravity includes a built-in migration workflow that imports your MCP servers, skills, custom commands, subagents, and instruction files from Claude Code, Codex, or Cursor directly into a personal Antigravity plugin.

Should beginners still read the original Antigravity setup guide?

Yes. Start with the Beginner Setup Guide if you need OS-specific installation instructions for Mac, Windows, or Linux, Gmail login troubleshooting, or detailed specs and pricing for Gemini 4 Carbon, Hydrogen, Argon, and Claude 5.5 models. Use this Antigravity 2.0 guide to master the redesigned desktop app, Manager Mode UI buttons, and multi-agent features.


Harshal Saraf is a Founder and Creative Director based in Indore, India. Through ByHarshal and Wiggly Works, he builds high-speed Astro and Next.js websites, SEO/AEO/GEO visibility engines, and custom AI workflows across India, the US, the UK, and the UAE. He also serves as Creative Director and AI Strategist at Square Root SEO and writes Oh, So AI every Tuesday and Friday.