Pular para o conteúdo

Para usuários do Antigravity

O Antigravity roda os agentes.
O Maguyva dá a eles o mapa.

O Antigravity é uma IDE agent-first: os agentes planejam e editam entre o editor, o terminal e o navegador. Num monorepo de verdade eles ainda precisam de um mapa de qual arquivo importa. O Maguyva indexa o seu codebase e devolve isso via MCP (semântica, AST, grafo e texto), para que “onde acontece a autenticação” retorne o fluxo de auth de verdade, não sete stubs de teste.

Comece grátisLeia a configuração do Antigravity

Plano Free: 3 repositórios, Até 50 mil linhas de repositório indexadas, sem cartão.

O Antigravity roda o agente. O Maguyva diz a ele qual arquivo tocar.

O que cada camada faz

Quatro peças. Cada uma com uma função.

// agent ide

Antigravity

Onde seus agentes planejam, editam e verificam.

// contexto manual

menções com @ + rules

Contexto manual funciona, até o repositório ficar grande.

// codebase

Maguyva

Fatos automáticos do codebase via MCP.

// quem paga

Workspaces, não assentos

Agentes não pagam assento. Ver preços

O Antigravity roda os agentes. Deixe.

A IDE de agentes não é o problema. O Agent Manager, a execução multi-superfície e os arquivos de rules são excelentes, e você já usa isso para:

  • Planejar e rodar agentes entre o editor, o terminal e o navegador.
  • Edições multi-arquivo quando a mudança é local.
  • Rules de agente para convenções do repositório e guardrails de estilo.
  • Menções com @ para trazer um arquivo específico para o contexto.

Continue fazendo isso. Nada disso vai embora.

Mas num monorepo de verdade (TypeScript com dependências de workspace, serviços Python, pacotes misturados) o contexto do agente quebra no momento em que o arquivo relevante ainda não está no radar do agente.

Soluções manuais que você já tentou, e onde elas quebram

Quatro soluções manuais emparelhadas com seus modos de falha. Esquerda = o que você faz hoje. Direita = onde quebra.

// the fix

// mencione os arquivos

Você menciona com @ os três arquivos que acha que importam. O agente edita neles com precisão.

// where it breaks

// mencionar é um chute

Funciona quando você já sabe quais arquivos estão envolvidos. Um agente autônomo precisa dos arquivos que você não sabia que precisava mencionar.

// the fix

// cole os trechos

Você cola 200 linhas de outro pacote no agente para dar contexto suficiente.

// where it breaks

// código colado fica desatualizado

O trecho que você colou às 9h não reflete o rebase que seu colega de time fez às 11h. O agente está editando contra uma versão fantasma do pacote.

// the fix

// escreva um doc de contexto

Você escreve um arquivo de rules de agente ou um markdown de arquitetura. Está certo hoje.

// where it breaks

// docs desatualizam mais rápido que o código

Tudo que você escreve à mão desatualiza. O código é a fonte da verdade. Um doc explicando a camada de fila está correto por uma semana, e errado para sempre depois.

// the fix

// mantenha os arquivos de rules

Você adiciona rules de agente para nomenclatura, lint e comandos de build. Ótimo para comportamento.

// where it breaks

// rules ≠ índice

As rules são o lugar certo para “sempre rode pnpm tsc -b antes de cada commit.” Elas não são um índice consultável de cada símbolo, arquivo e call-site no seu monorepo.

O Maguyva é a camada por baixo

Não é um substituto do Antigravity. É a camada de contexto de repositório que se conecta ao suporte MCP dele.

  • Semântica + AST + grafo + texto busca por significado, estrutura, dependência ou literal. Cada resultado retorna um caminho de arquivo e número de linha.
  • Entre pacotes por padrão call-sites e importadores em todos os pacotes do monorepo, não só no que o agente tem aberto.
  • Consciente de branch O Maguyva enxerga a versão do código que o agente está editando.
  • Feito para autonomia um agente que planeja muitas edições precisa do raio de impacto de antemão, não depois que o CI fica vermelho.

O Antigravity decide o que editar.

O Maguyva diz ao agente o que a edição afeta.

Três fluxos de trabalho de monorepo

Entre pacotes, entre linguagens. Fundamentado no grafo de chamadas real, não no grep do agente.

// workflow 01

Encontre o fluxo de auth entre pacotes, sem mencionar nada

agent> onde acontece a autenticação nesse monorepo?

graph::query("authentication flow")
  packages/web/src/auth/session.ts:42       middleware
  packages/api/src/auth/jwt.ts:88           token verify
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  rbac gate

→ 4 pontos de entrada em 4 pacotes, ranqueados por densidade de call-sites.
[exit 0]

Você não mencionou nenhum arquivo. Você não colou nenhum trecho. O agente tem os quatro arquivos que importam, na ordem certa, e pode fazer uma edição fundamentada.

// workflow 02

Encontre a implementação real, não o stub de teste

agent> como o normalizePhoneNumber trata o E.164?

semantic::query("normalize phone E.164")
  packages/shared/util/phone.ts:88     normalizePhoneNumber()  ← impl real
  packages/api/test/phone.spec.ts:14   jest.mock(...)          ← stub
[exit 0]

Nomes mentem. Mocks fazem sombra no código real. O Maguyva ranqueia a implementação real acima do mock de teste, em todos os pacotes.

// workflow 03

Confira o raio de impacto antes do agente refatorar

agent> o que chama QueueDispatcher.publish em todo o monorepo?

graph::callers(QueueDispatcher.publish)
  3 em packages/billing/*
  1 em packages/audit/*
  1 em packages/notifications/*
  1 em services/python-worker/*  ← entre linguagens via stub gRPC
[exit 0]

Entre pacotes, e entre linguagens quando você tem um repositório poliglota, os call-sites aparecem inline. Um agente autônomo recebe o raio de impacto antes de editar, não depois que o CI fica vermelho.

Configuração com o Antigravity

Três passos. Plano Free: 3 repositórios, Até 50 mil linhas de repositório indexadas, sem cartão.

  1. // step 01

    Indexe um repositório em maguyva.ai

    Escolha o monorepo onde você mais sentiu dor de contexto.

  2. // step 02

    Adicione o Maguyva como servidor MCP no Antigravity

    // ~/.gemini/antigravity/mcp_config.json
{
  "mcpServers": {
    "maguyva": {
      "serverUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer <your-key>"
      }
    }
  }
}

  3. // step 03

    Faça uma pergunta cuja resposta você já saiba

    Não aponte o agente para a empresa inteira. Comece com um repositório e uma pergunta verificável, tipo “o que chama formatInvoice entre pacotes?”

Inscrições por autoatendimento abertas.

Indexe um repositório que você já conhece.

Teste uma pergunta cuja resposta você consiga verificar.

Indexe seu primeiro repositórioVer documentação de compatibilidade

plano gratuito: 3 repositórios, Até 50 mil linhas de repositório indexadas, sem cartão.