Hopp til innhold

For Windsurf-brukere

Windsurf redigerer filen.
Maguyva ser repoet.

Windsurf er editoren og Cascade er agenten. I et monorepo trenger agenten likevel et kart over hvilken fil som er relevant. Maguyva indekserer kodebasen din og gir den tilbake over MCP (semantisk, AST, graf og tekst), slik at «hvor skjer autentisering» gir den faktiske auth-flyten, ikke sju test-stubber.

Free tier: 3 repoer, Opptil 50K indekserte kodelinjer, uten kort.

Windsurf redigerer det du peker på. Maguyva forteller Cascade hvilken fil den skal peke på.

Hva hvert lag gjør

Fire deler. Hver har sin jobb.

// editor

Windsurf

Der du og Cascade faktisk jobber.

// manuell kontekst

@-mentions + .windsurfrules

Manuell kontekst vinner, helt til repoet blir stort.

// kodebase

Maguyva

Automatiske kodebasefakta over MCP.

// hvem betaler

Arbeidsområder, ikke seter

Agenter betaler ikke seter. Se priser

Windsurf er editoren. Bruk den.

IDE-en er ikke problemet. Cascade, tab-fullføring, redigering av flere filer samtidig, og .windsurfrules er utmerkede, og du bruker dem allerede til:

  • Innebygde forslag og Cascade-redigeringer i den åpne filen.
  • Redigering av flere filer når endringen er lokal.
  • .windsurfrules for repo-konvensjoner og stilregler.
  • @-mentions for å hente en bestemt fil inn i konteksten.

Fortsett med det. Ingenting av det forsvinner.

Men i et ekte monorepo (TypeScript med workspace-avhengigheter, Python-tjenester, blandede pakker) bryter agentkonteksten sammen i det øyeblikket den relevante filen ikke allerede er på Cascades radar.

Manuelle løsninger du allerede har prøvd, og hvor de svikter

Fire manuelle løsninger paret med sin feilmodus. Venstre = det du gjør i dag. Høyre = hvor det svikter.

// the fix

// nevn filene

Du @-nevner de tre filene du tror er relevante. Cascade redigerer rent i dem.

// where it breaks

// å nevne er en gjetning

Det fungerer når du allerede vet hvilke filer som er involvert. Hele poenget med kontekstverktøy er å avdekke filene du ikke visste du burde nevne.

// the fix

// lim inn utdragene

Du limer inn 200 linjer fra en annen pakke i Cascade for å gi den nok kontekst.

// where it breaks

// innlimt kode blir foreldet

Utdraget du limte inn klokken 9 gjenspeiler ikke rebasen kollegaen din landet klokken 11. Cascade redigerer mot en fantomversjon av pakken.

// the fix

// skriv et kontekstdokument

Du skriver en .windsurfrules-fil eller en arkitektur-markdown. Den stemmer i dag.

// where it breaks

// dokumentasjon drifter raskere enn kode

Alt du skriver for hånd drifter. Koden er sannheten. Et dokument som forklarer kølaget stemmer i en uke, og er feil for alltid deretter.

// the fix

// behold regelfilene

Du legger til .windsurfrules for navngiving, lint og byggekommandoer. Flott for atferd.

// where it breaks

// regler ≠ indeks

.windsurfrules er riktig sted for “kjør alltid pnpm tsc -b før commits.” Det er ikke en søkbar indeks over hvert symbol, hver fil og hvert kallsted i monorepoet ditt.

Maguyva er laget under

Ikke en erstatning for Windsurf. Repo-kontekstlaget som henger på Cascades MCP-støtte.

  • Semantisk + AST + graf + tekst søk etter mening, struktur, avhengighet eller ordrett tekst. Hvert treff gir en filbane og et linjenummer.
  • På tvers av pakker som standard kallsteder og importører på tvers av alle pakker i monorepoet, ikke bare den Cascade har åpen.
  • Branch-bevisst Maguyva ser versjonen av koden Cascade redigerer.
  • Utfyllende, ikke konkurrerende .windsurfrules fortsetter å gjøre jobben sin. @-mentions fortsetter å gjøre sin. Maguyva fyller hullet de ikke fyller.

Cascade redigerer filen du peker på.

Maguyva forteller agenten hvilken fil den skal peke på.

Tre monorepo-arbeidsflyter

På tvers av pakker og språk. Forankret i den faktiske kallgrafen, ikke Cascades grep.

// workflow 01

Finn auth-flyten på tvers av pakker, uten å nevne noe

cascade> hvor skjer autentisering i dette monorepoet?

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 inngangspunkter fordelt på 4 pakker, rangert etter kallsted-tetthet.
[exit 0]

Du nevnte ingen fil. Du limte ikke inn noe utdrag. Cascade har de fire filene som betyr noe, i riktig rekkefølge, og kan gjøre en forankret endring.

// workflow 02

Finn den faktiske implementasjonen, ikke test-stubben

cascade> hvordan håndterer normalizePhoneNumber E.164?

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

Navn lyver. Mocks skygger for ekte kode. Maguyva rangerer den ekte implementasjonen over test-mocken, i alle pakker.

// workflow 03

Sjekk påvirkningsradiusen før du refaktorerer

cascade> hva kaller QueueDispatcher.publish i hele monorepoet?

graph::callers(QueueDispatcher.publish)
  3 i packages/billing/*
  1 i packages/audit/*
  1 i packages/notifications/*
  1 i services/python-worker/*  ← på tvers av språk via gRPC-stub
[exit 0]

På tvers av pakker, og på tvers av språk når du har et polyglot repo, dukker kallstedene opp direkte. Diffen er forankret i faktiske importører, ikke Cascades grep.

Oppsett med Windsurf

Tre steg. Free tier: 3 repoer, Opptil 50K indekserte kodelinjer, uten kort.

  1. // step 01

    Indekser et repo på maguyva.ai

    Velg monorepoet der du har kjent mest på kontekstsmerte.

  2. // step 02

    Legg til Maguyva som en MCP-server i Windsurf

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

    Still ett spørsmål du allerede vet svaret på

    Ikke start med hele selskapet ditt. Start med ett repo og ett verifiserbart spørsmål, som «hva kaller formatInvoice på tvers av pakker?»