Skip to content
Guide

What is Antigravity swarm and how do you use it?

Published · Last checked

What is Antigravity swarm and how do you use it?

Antigravity swarm lets you set up a team of agents with a single sentence: a leader splits the work into parts, gives each part to its own agent, the agents work at the same time, and a verifier checks the result. In our test, a five-member team added four pages to a small site in about 7 minutes, and all 33 tests it wrote passed. But swarm burns through quota fast: this job took 12 points of the 5-hour quota, so it's only worth using for broad work that splits into parts.

Step by step

  1. First pin down the task with /grill-me

    When you type /grill-me and describe the task, the agent doesn't start writing code right away; it asks you questions first. Under each question sits the answer it suggests. If you don't like it, you write your own, and it doesn't ask you things it can answer by reading the code. Doing this before swarm matters, because in a swarm every agent uses its own quota, and a vague task sends five agents the wrong way at once.

  2. Set up the team with /swarm

    In the same chat you type /swarm and ask it to carry out the plan, and the agent you're talking to becomes the team leader. The leader doesn't write code; it splits the work into parts and gives each part to a named agent. Our team had five members: one for the home page and shared design, one for the new pages, one for tests, a verifier that checks the work, and a monitor that steps in if everyone goes quiet.

  3. Watch the team on the board

    The agents don't message each other privately; everything lands on a single board. The link at the end of the leader's reply opens the swarm panel, where you see the board, the team members and a graph of who wrote to whom and how many times. If you open one agent and write to it, your message goes only to that agent, not to the board.

  4. Ask side questions with /btw

    While the team is working, you can ask about anything on your mind with /btw. The answer shows up in a separate place and doesn't interrupt the team's work.

  5. Keep an eye on your quota

    By Google's own warning, swarm burns through quota much faster than a single chat. An agent that runs out of quota doesn't carry on by itself; it waits. So if you leave swarm running and go to bed, you may not find the job done in the morning. Keep the AI Credit Overages setting, the one that spends credits once your quota runs out, set to Never; if it's on, swarm can cost you money.

  6. Pick the right tool for the job

    Not every job needs a team. For a small side task, a subagent already steps in on its own. Use /boost for a single hard problem, /swarm for broad work that splits into parts, and /goal for a single target where you want “done” to be backed by proof.

Worth remembering

  • The leader set up the team and the five-member team finished four pages in about 7 minutes; all 33 tests they wrote passed, and we also ran the tests ourselves.
  • This job used 12 points of the 5-hour quota and 3 points of the weekly quota; having a single agent build the first version of the same site had taken 7 points of the 5-hour quota, but the jobs were different, so we don't give an exact ratio.
  • A request we wrote directly to the agent building the pages, “the FAQ page should have at least five questions,” went only to that agent, and the agent applied it.
  • The browser subagent didn't carry the main chat's history, so it didn't know the site's address and kept guessing; when you give a subagent a task, you also have to give it the information it needs.
  • With the /goal target “fix the two bugs and make the tests pass,” the agent fixed both bugs and all the tests passed.

How I tried it

We recorded on Nov 15, 2026 with Antigravity 2.32.1 on a Google AI Ultra account; every agent on the team was Gemini 4 Argon. The sample task was adding four new pages to a small promo site that a single agent had built earlier. We read the quota percentage before and after the swarm, and we also ran the team's tests separately.

Who it is for

For Antigravity users who are thinking about splitting a job across several agents. If your quota is limited, this helps you tell which jobs need a team and which ones a single agent can finish.

Frequently asked questions

What is Antigravity swarm?

It's the Antigravity feature that gives a job to a team of agents instead of a single agent. A leader splits the work and gives each part to a named agent, the agents work at the same time, a verifier reads the work and runs the tests, and they all talk on a single board.

How do you use swarm in Antigravity?

First you pin down the task with /grill-me and get a plan, then you type /swarm in the same chat and ask it to carry out that plan. The link in the leader's reply opens the swarm panel; you watch the team there and, if needed, write directly to a single agent.

Is Antigravity swarm free?

Google's swarm page (read on Nov 15, 2026) lists swarm under the Google AI Pro and Ultra plans and says it is still in preview. We tested it on a Google AI Ultra account, not on a free account.