newspaperPress Guidelines
Pricing
Blog
Downloaddownload

Explore our next generation products

See overview

Products

antigravityAntigravity 2.0terminalAntigravity CLIcodeAntigravity IDEsdkAntigravity SDK

Built for developers in the agent-first era

See overview
EnterpriseFrontendFullstackScienceMarketer

Everything you need to stay up-to-date and get help

Documentationkeyboard_arrow_rightChangelogSupportPressReleases

Explore our next generation products

See overview

Products

antigravityAntigravity 2.0terminalAntigravity CLIcodeAntigravity IDEsdkAntigravity SDK

Built for developers in the agent-first era

See overview
EnterpriseFrontendFullstackScienceMarketer
Pricing
Blog

Everything you need to stay up-to-date and get help

Documentationkeyboard_arrow_rightChangelogSupportPressReleases
Home
Antigravity 2.0v2.3.1keyboard_arrow_right
Overview
Getting Started
Build with Google
Feature Overview
Models
Projects
Settingskeyboard_arrow_right
Overview
Agent Settings
Artifact Review
Customizationskeyboard_arrow_right
MCP
Skills
Rules
Plugins
Hooks
Sidecars
Agent Capabilitieskeyboard_arrow_right
Permissions
Subagents
Artifactskeyboard_arrow_right
Overview
Plan
Walkthrough
Screenshots
Antigravity CLIv1.1.5keyboard_arrow_right
Overview
Getting Started
Installation & Auth
Tutorial
Using AGY CLI
Features
Gemini Migration
Prompting
Artifactskeyboard_arrow_right
Overview
Conversations
Agent Capabilitieskeyboard_arrow_right
Choose an execution mode
Subagents
Sandbox
Permissions
Projects
Settingskeyboard_arrow_right
Overview
AI Credits
Customizationskeyboard_arrow_right
MCP
Plugins & Skills
Status Line
Window Title
Commandskeyboard_arrow_right
Agents (/agents)
Code Search (/codesearch)
AI Credits (/credits)
Diff (/diff)
Permissions (/permissions)
Resume (/resume)
Status Line (/statusline)
Window Title (/title)
Model Quotas (/usage, /quota)
Best Practices
Troubleshooting
Reference
Antigravity SDKv0.1.7keyboard_arrow_right
Overview + Quick Start
Customizationskeyboard_arrow_right
MCP
Antigravity IDEv2.1.1keyboard_arrow_right
Overview
Getting Started
Featureskeyboard_arrow_right
Tab
Side Panel
Review Changes
Artifactskeyboard_arrow_right
Plan
Walkthrough
Screenshots
Browser Recordings
Browserkeyboard_arrow_right
Overview
Allowlist / Denylist
Separate Chrome Profile
Customizationskeyboard_arrow_right
MCP
Skills
Rules
Workflows
Plugins
Hooks
Settings
Migrationkeyboard_arrow_right
Firebase Studio Migration
Enterprise
Plans
FAQ
  • side_navigation
  • Antigravity CLI
  • >
  • Agent Capabilities
  • >
  • Subagents

Background tasks & subagentslink

Delegate slow builds, multi-file code generation, and research sweeps to parallel background agents while maintaining your active programming flow.

Asynchronous execution modellink

To maximize developer velocity, Antigravity CLI leverages a multi-threaded asynchronous execution architecture. Instead of locking your terminal session during long-running builds, massive codebase search sweeps, or complex multi-file edits, the primary agent delegates these operations to parallel Subagents or background Tasks.
This delegation model ensures you never have to wait on high-latency AI processes. You can continue drafting code, submitting prompts, or inspecting files while multiple autonomous background threads execute validation tasks in parallel.

Managing agents: The `/agents` panellink

The active agent-hierarchy and custom agent selection menu are fully transparent and manageable through the interactive Agent Manager Panel (/agents).

Opening the panellink

Type /agents in the prompt and press Enter to open the interactive Agent Manager Panel.

Panel overviewlink

The panel displays a live checklist of all active, completed, killed, or failed background agents:
  • Identifier: The unique target subagent ID.
  • Role: The specialized role of the agent (such as "Codebase Researcher" or "Database Debugger").
  • State: Live status indicators (running, done, killed, or error).
  • Step: A real-time summary of the tool or reasoning step currently being executed.
> Tip: You can also select and switch between custom agents (or fork conversations) from this panel. See the /agents command reference for full details on custom agent discovery and panel keybindings.

Deep-dive monitoringlink

To inspect the inner reasoning, thoughts, and logs of a specific background agent:
  1. Open the /agents panel and highlight the target agent using ↑/↓.
  2. Press Enter to open the Subagent Detail View.
  3. This full-screen view reveals the subagent's entire reasoning log, including its private internal thoughts, tool calls, and execution outputs.
  4. Press Esc to exit and return to the main Agent Manager list.

Monitoring background tasks with `/tasks`link

For non-agentic background operations, such as direct shell commands, testing suites, or simple background queries initiated via /btw, use the /tasks command.
text
/tasks
The tasks tracking list lets you:
  • Track standard non-interactive background processes.
  • Select a task using ↑/↓ and press Enter to view stdout logs.
  • Terminate runaway terminal processes safely.

Keyboard ergonomicslink

To reduce context-switching friction when subagents require manual interaction or tool authorizations, Antigravity CLI integrates high-efficiency shortcut paths.

Detailed "Teleport" navigation (`Alt+J`)link

When a subagent encounters a tool requiring approval (e.g. writing a file or running a database migration), a status bar notification blinks.
  • Press Alt+J inside the main prompt panel to instantly "teleport" from your current conversation directly into the Detail View of the next subagent awaiting your approval.
  • Confirm or reject the action, and press Esc to teleport back to your primary thread.

"Fast-Path" confirmations (`Ctrl+K`)link

To authorize an agent action instantly without leaving your active workspace:
  1. Look at the inline status notification displayed right above your active prompt box. It summarizes the pending action (e.g., Subagent 12 asks to run "npm test").
  2. Press Ctrl+K to instantly approve the pending fast-path action without switching panels or opening overlays.

Next stepslink

Configure the visual shell behavior and customize your configuration profiles:
  • Settings, Rendering & Keybindings: Customize key maps, buffering, and JSON rules.
  • Permissions & Sandbox: Enforce security containment rings on background processes.
  • Plugins & Skills: Create your own custom skills and slash commands.
Projects
Sandbox
On this Page
Background tasks & subagentsAsynchronous execution modelManaging agents: The `/agents` panelDeep-dive monitoringMonitoring background tasks with `/tasks`Keyboard ergonomicsNext steps