Antigravity swarm é um comando de barra em prévia no Google Antigravity que transforma um único prompt em uma equipe de agentes paralelos. Digite /swarm <task>, e sua conversa se torna um coordenador que divide o trabalho entre workers nomeados, adiciona um @verifier para revisar diffs e executar testes, e mantém todos em um quadro de mensagens compartilhado. É necessário um plano Google AI Pro ou Ultra, e o consumo de quota é bem maior do que o de um único agente.
O que é o Antigravity swarm?
O Antigravity swarm é o comando /swarm do App e da CLI do Antigravity. Ele executa uma equipe de agentes nomeados que dividem uma tarefa, trabalham nas partes ao mesmo tempo e se coordenam publicamente em um quadro compartilhado. Use-o quando uma tarefa se divide de forma limpa entre arquivos, pacotes ou perguntas separadas, e você quiser um segundo agente para testar o resultado.

A Google apresentou o comando no lançamento do Gemini 4 Neon, em 18 de novembro de 2026, com demonstrações como uma planilha Google movida por mais de 500.000 fórmulas em tempo real. A parte útil é o mecanismo, detalhado na documentação do /swarm. Este guia cobre como ele funciona, quanto custa e onde um quadro de tarefas compartilhado como o Sharkly se encaixa junto dele.
Como funciona o /swarm: coordenador, workers e verificador
Quando você executa /swarm <task>, a conversa atual se torna o coordenador. Ele não escreve código. Ele distribui o trabalho, julga o que volta e informa você. Esta é a sequência descrita na documentação:
- O coordenador divide a tarefa. Ele nomeia o swarm e adiciona um worker por parte que não vai gerar conflito, como
@parser,@api-testsou@docs. Para um conjunto de trabalhos semelhantes, ele pode criar um grupo numerado, de@fix-1a@fix-4. - Cada worker recebe um briefing público. Um worker começa com um contexto limpo. O briefing dele (o que é responsabilidade dele, o que não deve tocar e o que significa "pronto") é publicado no quadro.
- Um verificador confere o trabalho. O coordenador normalmente adiciona um
@verifierpara cada dois a quatro workers. Ele lê os diffs, executa os testes e devolve os problemas aos autores. - Todos conversam no quadro. Atribuições, perguntas, resumos de diffs e resultados de testes vão para o quadro com
@name,@groupou@all. Ninguém troca mensagens em privado. - Membros ociosos dormem de graça. Um worker sem nada a fazer espera no quadro sem consumir tokens e acorda quando alguém o menciona.
Também existe o worker @monitor. Ele permanece dormindo enquanto o swarm avança e publica apenas se todos os membros ficarem em silêncio antes de o trabalho terminar.

Esse quadro público é a principal diferença em relação aos subagents, que reportam em privado ao agente que os criou. Nosso explainer sobre enxames de agentes de IA cobre o padrão geral.
Modelos e workspaces dos workers
Os workers rodam no mesmo modelo da sua conversa, a menos que você especifique o contrário. Você pode pedir uma divisão no próprio prompt, por exemplo "execute o verificador em um modelo diferente dos workers", desde que esse modelo esteja disponível no seu seletor de modelos.
Por padrão, os workers compartilham seu workspace. Quando vários editam ao mesmo tempo, o coordenador pode dar a cada um sua própria cópia de trabalho do repositório — a mesma ideia por trás dos agentes paralelos em worktrees isolados fora do Antigravity.
Como executar seu primeiro Antigravity swarm
Os passos são praticamente idênticos no App e na CLI.
- Abra uma conversa no seu projeto, digite
/swarme pressione Tab para inserir o comando. - Descreva a tarefa e como verificá-la.
- Aguarde o coordenador adicionar os workers e publicar os briefings deles.
- Abra o quadro: clique em Open the Swarm UI no App, ou execute
/swarm board(ou pressione Alt+S) na CLI. - Continue conversando com o coordenador enquanto o swarm roda. Peça status ou mude o plano.
O primeiro exemplo da própria Google é um bom modelo:
/swarm Add unit tests for the date utilities in src/utils/date.ts and the
currency formatter in src/utils/currency.ts, and run npm test to verify.
Para falar com um worker específico, inicie um prompt na CLI com o nome dele, por exemplo @verifier also run the integration tests, ou abra-o na aba Members do App. Essa mensagem não passa pelo quadro.
Escrevendo um prompt de /swarm que se divide bem
O coordenador decide quantos workers adicionar, então o papel do seu prompt é deixar a divisão óbvia e a linha de chegada testável. Três hábitos ajudam:
- Nomeie as fronteiras. Liste os arquivos, pacotes ou perguntas para que cada worker seja responsável por um.
- Nomeie a verificação. Diga qual comando comprova o trabalho, como
npm testougo test -race ./.... - Nomeie a restrição. "Corrija as falhas sem deletar asserções" impede que um worker faça os testes passarem do jeito mais barato.
/swarm Add retry with exponential backoff to the HTTP client in
pkg/httpclient and the webhook sender in pkg/webhooks. Run the verifier
on a different model than the workers, and have it check for race
conditions and run go test -race ./....
Swarm vs subagents vs /boost vs /teamwork
O Antigravity oferece quatro formas de usar mais de um agente. Escolha pelo formato do problema, não pelo tamanho dele.
| Subagents | /boost |
/swarm |
/teamwork |
|
|---|---|---|---|---|
| Melhor para | Uma tarefa lateral focada | Um bug difícil ou refatoração complicada | Trabalho amplo que se divide de forma limpa | Projetos com vários marcos |
| Coordenação | Relatório privado ao agente pai | Desafio e correção iterativos | Quadro compartilhado com @mentions | Plano de marcos com portões de revisão |
| Horizonte típico | Segundos a minutos | Segundos a horas | Minutos a horas | Horas a dias |
| Nível de plano | Todos os planos | Planos pagos | Google AI Pro e Ultra | Planos pagos |
Use /swarm quando a tarefa for ampla e se dividir de forma limpa. Use /boost quando o problema for difícil, e não amplo, porque uma race condition não fica mais fácil com quatro agentes cutucando o código. Use /teamwork quando o trabalho se estender por dias e precisar de uma entrevista de escopo primeiro.
Executando o /swarm no Gemini 4 Neon
A Google apresenta o Neon como um orquestrador rápido que direciona subagents Hydrogen paralelos no Antigravity. Ele está disponível lá para assinantes pagos do Google AI Pro e Ultra. Fora do Antigravity, os dados da API são estes, conforme a página de preços da API Gemini e a página de modelos:
| Gemini 4 Neon | Valor |
|---|---|
| Código do modelo | gemini-4-neon |
| Entrada, por 1M de tokens | $3.00 |
| Saída (incl. thinking), por 1M de tokens | $15.00 |
| Entrada em cache, por 1M de tokens | $0.15 (apenas cache implícito) |
| Janela de contexto | 1.048.576 tokens |
| Nível gratuito da API | Não disponível |
O Neon tem quatro níveis de thinking. O high é o padrão e o xhigh é o máximo. A Google diz que, no high, o Neon custa 32% menos por tarefa que o Gemini 4 Carbon. Para um swarm, isso importa mais do que o normal: cada worker é um agente próprio, então o custo por tarefa se multiplica pelo número de membros. Uma divisão sensata é usar o Neon como coordenador e verificador, com workers mais rápidos — algo que a documentação permite pedir no prompt. Nosso guia do Gemini 4 Hydrogen cobre o lado dos workers.
Custos, limites e modos de falha
O Swarm está em prévia, e a documentação é direta: um swarm "consome quota muito mais rápido que uma única conversa".
- Pausas de quota não se resolvem sozinhas. Um membro que fica sem quota pausa e permanece pausado até uma nova publicação no quadro, uma troca de modelo ou uma mensagem sua. Ele não reinicia quando a quota é renovada.
- Removido é permanente. Um worker removido não pode ser revivido; o coordenador adiciona um novo.
- Aprovações continuam bloqueando. Um worker esperando a aprovação de uma ferramenta para. Na CLI, Alt+J pula para o próximo que está esperando.
- Edições sobrepostas exigem cópias de trabalho. Se dois workers tocarem no mesmo arquivo em um workspace compartilhado, peça cópias separadas.
Se você não tem certeza de que seu plano inclui o /swarm, nossa análise sobre se o Antigravity é gratuito lista o que cada nível oferece.
Onde um quadro de tarefas se encaixa junto ao /swarm
O quadro de um swarm tem o escopo de uma única conversa na sessão de um único desenvolvedor. Ele responde bem à pergunta "o que esses workers estão fazendo agora?". Ele não responde "o que cada agente do time está fazendo nesta semana, quem pediu e quem aprovou?"
Essa segunda pergunta é o trabalho de um quadro de tarefas de equipe. O Sharkly não é um substituto do Antigravity nem de nenhum agente de código. Ele adiciona a camada compartilhada de tarefas, Computers, contexto e revisão em volta dos agentes que seu time já usa, como Claude Code, Codex, Gemini CLI e OpenCode. O Antigravity não está entre os Runtimes que o Sharkly executa hoje, então trate os dois como camadas separadas.
Veja como as peças se correspondem:
| Aspecto | Antigravity /swarm | Sharkly |
|---|---|---|
| Unidade de trabalho | Um prompt em uma conversa | Uma Task em um quadro compartilhado |
| Equipe de agentes | Coordenador mais workers nomeados | Uma Crew: um Agent líder mais Agents e People |
| Isolamento | Cópia de trabalho opcional por worker | Diretório isolado por Task, worktree por execução |
| Para onde vão os resultados | O quadro e a resposta do coordenador | De volta à Task, com progresso e eventos de trace |
| Quem aceita o trabalho | Você, na conversa | Uma pessoa responsável revisando na Task |

Segundo a documentação do Sharkly, cada Task roda em seu próprio worktree isolado, e o progresso, os eventos de trace e o resultado voltam para a Task. Agents pesquisam, executam, testam e reportam. People definem a direção e aceitam o resultado. Quando as revisões começam a se acumular entre agentes paralelos, leia por que a revisão humana se torna o gargalo.
Para trabalhos pequenos e bem definidos, envie o prompt diretamente ao agente padrão; uma correção de um único arquivo com quatro workers custa mais e não termina mais cedo. Use /swarm quando a tarefa tiver três ou mais partes que não compartilham arquivos e um teste que comprova cada uma.
Conclusão
O Antigravity swarm dá a um único desenvolvedor um coordenador, workers nomeados, um verificador e um quadro público em um só comando. Suas limitações são a quota, o rótulo de prévia e o escopo de uma conversa. Comece com uma tarefa que se divida por arquivos e tenha um comando de teste. Quando os agentes do seu time precisarem de um quadro compartilhado acima do swarm, conecte um Computer e atribua sua primeira Task no Sharkly.
FAQ
O que o /swarm faz no Google Antigravity?
Ele transforma sua conversa em um coordenador que divide uma tarefa entre agentes workers nomeados executando em paralelo, geralmente com um verificador que revisa diffs e roda testes. Todos os membros se coordenam em um quadro de mensagens compartilhado com @mentions.
O Antigravity swarm é gratuito?
Não. A documentação lista o /swarm nos planos Google AI Pro e Google AI Ultra, no App e na CLI do Antigravity. Os subagents estão disponíveis em todos os planos.
Quantos workers um swarm usa?
O coordenador decide com base em como a tarefa se divide. Ele geralmente adiciona um verificador para cada dois a quatro workers, mais um monitor. A documentação do /swarm não publica um máximo.
Os workers do swarm podem usar modelos diferentes?
Sim. Os workers usam por padrão o modelo da sua conversa, mas você pode pedir um modelo diferente para um worker ou para todos, desde que seja possível selecioná-lo no seletor de modelos.
Qual é a diferença entre /swarm e subagents?
Os subagents rodam em segundo plano e reportam em privado ao agente que os iniciou. Os workers do swarm conversam publicamente em um quadro compartilhado, e os workers ociosos dormem sem consumir tokens até serem mencionados.



