Vai al contenuto

Per gli utenti di Cursor

Cursor modifica il file.
Maguyva vede il repo.

Cursor è l'editor. In un monorepo, l'agente ha comunque bisogno di una mappa per capire quali file contano. 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.

Inizia gratis Leggi la guida alla configurazione per Cursor

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

Cursor modifica quello che indichi. Maguyva dice all'agente quale file indicare.

Cosa fa ogni livello

Quattro pezzi. Ognuno ha un compito.

// editor

Cursor

Dove scrivi davvero il codice.

// contesto manuale

@ mentions + pin

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

// codebase

Maguyva

Informazioni sul codebase ricavate automaticamente e disponibili via MCP.

// chi paga

Workspace, non utenti

Gli agenti non comportano costi per utente. Vedi i prezzi

Cursor è l'editor. Usalo.

L'IDE non è il problema. Il completamento con il tasto Tab di Cursor, l'edit-with-AI, le modifiche multi-file e .cursor/rules sono eccellenti, e li usi già per:

  • Suggerimenti inline ed edit-with-AI nel file aperto.
  • Modifiche multi-file quando il cambiamento è locale.
  • .cursor/rules 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 tuo radar.

Soluzioni manuali che hai già provato e dove non bastano più

Quattro soluzioni manuali, ciascuna con il proprio limite. A sinistra = cosa fai oggi. A destra = dove non funziona più.

// the fix

// fissa i file

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

// where it breaks

// fissare è indovinare

Fissare i file funziona quando sai già quali sono coinvolti. Lo scopo degli strumenti di contesto è proprio far emergere i file che non sapevi di dover fissare.

// the fix

// incolla gli snippet

Incolli 200 righe da un altro pacchetto nella chat per dare all'agente 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 apportando modifiche sulla base di una versione fantasma del pacchetto.

// the fix

// scrivi un documento di contesto

Scrivi un file .cursor/rules 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 .cursor/rules per nomenclatura, lint, comandi di build. Ottimo per il comportamento.

// where it breaks

// regole ≠ indice

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

Maguyva è il livello sottostante

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

  • 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 moduli che effettuano gli import in tutti i pacchetti del monorepo, non solo in quello aperto al momento.
  • Tiene conto del branch Maguyva vede la versione del codice che Cursor sta modificando.
  • Complementare, non competitivo .cursor/rules continua a fare il suo lavoro. Le menzioni con @ continuano a fare il loro. Maguyva colma il vuoto che loro non coprono.

Cursor modifica il file che indichi.

Maguyva dice all'agente quale file indicare.

Tre flussi di lavoro per monorepo

Tra pacchetti, tra linguaggi. Basati sul grafo di chiamate reale, non sul grep di Cursor.

// workflow 01

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

cursor> 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 fissato nessun file. Non hai incollato nessuno snippet. L'agente ha i quattro file che contano, nell'ordine corretto, e può apportare una modifica basata sul codice reale.

// workflow 02

Trova l'implementazione reale, non lo stub di test

cursor> 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 di refactorizzare

cursor> 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. Il diff si basa sui moduli che effettuano davvero gli import, non sul grep di Cursor.

Configurazione con Cursor

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

  1. // step 01

    Indicizza un repo su maguyva.ai

    Scegli il monorepo in cui la mancanza di contesto ti ha creato più problemi.

  2. // step 02

    Aggiungi Maguyva come server MCP nelle impostazioni di Cursor

    ~/.cursor/mcp.json

    {
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

  3. // step 03

    Fai una domanda di cui conosci già la risposta

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

Iscrizioni self-service aperte.

Indicizza un repo che già conosci.

Prova una domanda di cui puoi verificare la risposta.

Indicizza il tuo primo repository Vedi la documentazione di compatibilità

piano gratuito: 3 repository, Fino a 50K righe di repository indicizzate, senza carta di credito.

Correlati

Da leggere

Tutte le integrazioni