Vai al contenuto

Per gli utenti di Antigravity

Antigravity esegue gli agenti.
Maguyva dà loro la mappa.

Antigravity è un IDE pensato prima di tutto per gli agenti: gli agenti pianificano e modificano su editor, terminale e browser. Su un vero monorepo hanno comunque bisogno di una mappa di quale file conta. Maguyva indicizza il tuo codebase e lo restituisce via MCP (semantico, AST, grafo e testo), così “dove avviene l'autenticazione” restituisce il flusso di auth reale, non sette stub di test.

Piano Free: 3 repository, Fino a 50K righe di repository indicizzate, senza carta.

Antigravity esegue l'agente. Maguyva gli dice quale file toccare.

Cosa fa ogni livello

Quattro pezzi. Ognuno ha un compito.

// agent ide

Antigravity

Dove i tuoi agenti pianificano, modificano e verificano.

// contesto manuale

@ mentions + regole

Il contesto manuale funziona, finché il repo non diventa grande.

// codebase

Maguyva

Fatti automatici sul codebase via MCP.

// chi paga

Workspace, non postazioni

Gli agenti non pagano postazioni. Vedi i prezzi

Antigravity esegue gli agenti. Lascialo fare.

L'IDE per agenti non è il problema. L'Agent Manager, l'esecuzione multi-superficie e i file di regole sono eccellenti, e li usi già per:

  • Pianificare ed eseguire agenti su editor, terminale e browser.
  • Modifiche multi-file quando il cambiamento è locale.
  • Regole per gli agenti per le convenzioni del repo e le regole di stile.
  • Menzioni con @ per portare un file specifico nel contesto.

Continua a farlo. Niente di tutto ciò scompare.

Ma in un vero monorepo (TypeScript con dipendenze di workspace, servizi Python, pacchetti misti) il contesto dell'agente si rompe nel momento in cui il file rilevante non è già sul radar dell'agente.

Soluzioni manuali che hai già provato, e dove si rompono

Quattro soluzioni manuali abbinate alla loro modalità di fallimento. Sinistra = cosa fai oggi. Destra = dove si rompe.

// the fix

// menziona i file

Menzioni con @ i tre file che pensi contino. L'agente modifica in modo pulito al loro interno.

// where it breaks

// menzionare è indovinare

Funziona quando sai già quali file sono coinvolti. Un agente autonomo ha bisogno dei file che non sapevi di dover menzionare.

// the fix

// incolla gli snippet

Incolli 200 righe da un altro pacchetto nell'agente per dargli contesto sufficiente.

// where it breaks

// il codice incollato invecchia

Lo snippet che hai incollato alle 9 del mattino non riflette il rebase che il tuo collega ha fatto alle 11. L'agente sta modificando contro una versione fantasma del pacchetto.

// the fix

// scrivi un documento di contesto

Scrivi un file di regole per l'agente o un markdown di architettura. Oggi è corretto.

// where it breaks

// i documenti invecchiano più in fretta del codice

Tutto ciò che scrivi a mano invecchia. Il codice è la fonte di verità. Un documento che spiega il livello delle code è corretto per una settimana, poi è sbagliato per sempre.

// the fix

// mantieni i file di regole

Aggiungi regole per l'agente per nomenclatura, lint e comandi di build. Ottimo per il comportamento.

// where it breaks

// regole ≠ indice

Le regole sono il posto giusto per “esegui sempre pnpm tsc -b prima dei commit.” Non sono un indice consultabile di ogni simbolo, file e punto di chiamata nel tuo monorepo.

Maguyva è il livello sottostante

Non è un sostituto di Antigravity. È il livello di contesto del repo che si aggancia al suo supporto MCP.

  • Semantico + AST + grafo + testo cerca per significato, struttura, dipendenza o testo letterale. Ogni risultato restituisce un percorso di file e un numero di riga.
  • Tra pacchetti per impostazione predefinita punti di chiamata e importatori in tutti i pacchetti del monorepo, non solo in quello che l'agente ha aperto.
  • Consapevole del branch Maguyva vede la versione del codice che l'agente sta modificando.
  • Pensato per l'autonomia un agente che pianifica molte modifiche ha bisogno del raggio d'impatto in anticipo, non dopo che la CI diventa rossa.

Antigravity decide cosa modificare.

Maguyva dice all'agente cosa tocca la modifica.

Tre flussi di lavoro per monorepo

Tra pacchetti, tra linguaggi. Fondato sul grafo di chiamate reale, non sul grep dell'agente.

// workflow 01

Trova il flusso di autenticazione tra i pacchetti, senza menzionare nulla

agent> dove avviene l'autenticazione in questo 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 punti di ingresso in 4 pacchetti, ordinati per densità di punti di chiamata.
[exit 0]

Non hai menzionato nessun file. Non hai incollato nessuno snippet. L'agente ha i quattro file che contano, nell'ordine corretto, e può fare una modifica fondata.

// workflow 02

Trova l'implementazione reale, non lo stub di test

agent> come gestisce normalizePhoneNumber il formato E.164?

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

I nomi mentono. I mock oscurano il codice reale. Maguyva classifica l'implementazione reale sopra il mock di test, in ogni pacchetto.

// workflow 03

Controlla il raggio d'impatto prima che l'agente refactorizzi

agent> cosa chiama QueueDispatcher.publish in tutto il monorepo?

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

Tra pacchetti, e tra linguaggi quando hai un repo poliglotta, i punti di chiamata emergono inline. Un agente autonomo ottiene il raggio d'impatto prima di modificare, non dopo che la CI diventa rossa.

Configurazione con Antigravity

Tre passaggi. Piano Free: 3 repository, Fino a 50K righe di repository indicizzate, senza carta.

  1. // step 01

    Indicizza un repo su maguyva.ai

    Scegli il monorepo dove hai sentito di più il problema del contesto.

  2. // step 02

    Aggiungi Maguyva come server MCP in Antigravity

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

    Fai una domanda di cui conosci già la risposta

    Non puntare l'agente su tutta la tua azienda. Inizia con un repo e una domanda verificabile, come “cosa chiama formatInvoice tra i pacchetti?”