Zum Inhalt springen

Für Windsurf-Nutzer

Windsurf bearbeitet die Datei.
Maguyva sieht das Repo.

Windsurf ist der Editor, Cascade der Agent. In einem Monorepo braucht der Agent trotzdem eine Karte, welche Datei relevant ist. Maguyva indexiert deine Codebase und liefert sie über MCP zurück (semantisch, AST, Graph und Text), damit „wo passiert Auth“ den echten Auth-Flow liefert, nicht sieben Test-Stubs.

Kostenlos startenWindsurf-Setup lesen

Free-Stufe: 3 Repositories, Bis zu 50K indexierte Repo-Zeilen, keine Karte.

Windsurf bearbeitet, worauf du zeigst. Maguyva sagt Cascade, worauf es zeigen soll.

Was jede Schicht macht

Vier Bausteine. Jeder hat eine Aufgabe.

// editor

Windsurf

Wo du und Cascade tatsächlich arbeiten.

// manueller kontext

@-Erwähnungen + .windsurfrules

Manueller Kontext funktioniert, bis das Repo groß wird.

// codebase

Maguyva

Automatische Codebase-Fakten über MCP.

// wer zahlt

Workspaces, keine Seats

Agenten zahlen keine Seats. Preise ansehen

Windsurf ist der Editor. Nutz ihn.

Die IDE ist nicht das Problem. Cascade, Tab-Vervollständigung, Multi-Datei-Edits und .windsurfrules sind exzellent, und du nutzt sie bereits für:

  • Inline-Vorschläge und Cascade-Edits in der offenen Datei.
  • Multi-Datei-Edits, wenn die Änderung lokal ist.
  • .windsurfrules für Repo-Konventionen und Style-Guardrails.
  • @-Erwähnungen, um eine bestimmte Datei in den Kontext zu holen.

Mach weiter so. Nichts davon verschwindet.

Aber in einem echten Monorepo (TypeScript mit Workspace-Deps, Python-Services, gemischte Packages) bricht der Agent-Kontext in dem Moment zusammen, in dem die relevante Datei noch nicht auf dem Radar von Cascade ist.

Manuelle Fixes, die du schon probiert hast, und wo sie versagen

Vier manuelle Fixes, gepaart mit ihrem Fehlermodus. Links = was du heute tust. Rechts = wo es bricht.

// the fix

// die dateien erwähnen

Du erwähnst mit @ die drei Dateien, die du für relevant hältst. Cascade editiert sauber innerhalb davon.

// where it breaks

// erwähnen ist eine vermutung

Es funktioniert, wenn du schon weißt, welche Dateien betroffen sind. Der ganze Sinn von Kontext-Tools ist, die Dateien zu zeigen, die du nicht wusstest zu erwähnen.

// the fix

// die snippets einfügen

Du fügst 200 Zeilen aus einem anderen Package in Cascade ein, um ihm genug Kontext zu geben.

// where it breaks

// eingefügter code veraltet

Das Snippet, das du um 9 Uhr eingefügt hast, spiegelt nicht das Rebase wider, das dein Teamkollege um 11 Uhr gelandet hat. Cascade editiert gegen eine Phantom-Version des Packages.

// the fix

// ein kontext-doc schreiben

Du schreibst eine .windsurfrules-Datei oder ein Architektur-Markdown. Heute stimmt es noch.

// where it breaks

// docs veralten schneller als code

Alles, was du von Hand schreibst, veraltet. Der Code ist die Quelle der Wahrheit. Ein Doc, das die Queue-Schicht erklärt, stimmt eine Woche lang, dann für immer nicht mehr.

// the fix

// die rules-dateien behalten

Du fügst .windsurfrules für Namenskonventionen, Lint und Build-Befehle hinzu. Großartig für Verhalten.

// where it breaks

// rules ≠ index

.windsurfrules ist der richtige Ort für „führe immer pnpm tsc -b vor Commits aus“. Es ist kein abfragbarer Index jedes Symbols, jeder Datei und jeder Aufrufstelle in deinem Monorepo.

Maguyva ist die Schicht darunter

Kein Windsurf-Ersatz. Die Repo-Kontext-Schicht, die an den MCP-Support von Cascade andockt.

  • Semantisch + AST + Graph + Text Suche nach Bedeutung, Struktur, Abhängigkeit oder Wortlaut. Jeder Treffer liefert Dateipfad und Zeilennummer.
  • Standardmäßig paketübergreifend Aufrufstellen und Importeure über jedes Package im Monorepo hinweg, nicht nur das, das Cascade gerade geöffnet hat.
  • Branch-bewusst Maguyva sieht die Version des Codes, die Cascade gerade editiert.
  • Ergänzend, nicht konkurrierend .windsurfrules erledigt weiter seine Aufgabe. @-Erwähnungen erledigen weiter ihre. Maguyva füllt die Lücke, die sie nicht abdecken.

Cascade bearbeitet die Datei, auf die du zeigst.

Maguyva sagt dem Agenten, worauf er zeigen soll.

Drei Monorepo-Workflows

Paket- und sprachübergreifend. Verankert im echten Call-Graph, nicht im Grep von Cascade.

// workflow 01

Den Auth-Flow paketübergreifend finden, ohne irgendetwas zu erwähnen

cascade> wo passiert Authentifizierung in diesem 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 Einstiegspunkte über 4 Packages, sortiert nach Aufrufstellen-Dichte.
[exit 0]

Du hast keine Datei erwähnt. Du hast kein Snippet eingefügt. Cascade hat die vier relevanten Dateien, in der richtigen Reihenfolge, und kann einen verankerten Edit machen.

// workflow 02

Die echte Implementierung finden, nicht den Test-Stub

cascade> wie behandelt normalizePhoneNumber E.164?

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

Namen lügen. Mocks überschatten echten Code. Maguyva reiht die echte Implementierung über dem Test-Mock ein, über jedes Package hinweg.

// workflow 03

Auswirkungsradius prüfen, bevor du refactorst

cascade> was ruft QueueDispatcher.publish im gesamten Monorepo auf?

graph::callers(QueueDispatcher.publish)
  3 in packages/billing/*
  1 in packages/audit/*
  1 in packages/notifications/*
  1 in services/python-worker/*  ← sprachübergreifend über gRPC-Stub
[exit 0]

Paketübergreifend, und bei einem polyglotten Repo auch sprachübergreifend, tauchen Aufrufstellen inline auf. Der Diff ist an echten Importeuren verankert, nicht am Grep von Cascade.

Setup mit Windsurf

Drei Schritte. Free-Stufe: 3 Repositories, Bis zu 50K indexierte Repo-Zeilen, keine Karte.

  1. // step 01

    Ein Repo auf maguyva.ai indexieren

    Wähl das Monorepo, bei dem du den meisten Kontext-Schmerz gespürt hast.

  2. // step 02

    Maguyva als MCP-Server in Windsurf hinzufügen

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

  3. // step 03

    Eine Frage stellen, deren Antwort du schon kennst

    Fang nicht mit deiner ganzen Firma an. Fang mit einem Repo und einer überprüfbaren Frage an, etwa „was ruft formatInvoice paketübergreifend auf?“

Self-Service-Anmeldung geöffnet.

Indexiere ein Repo, das du schon kennst.

Teste eine Frage, deren Antwort du überprüfen kannst.

Dein erstes Repo indexierenKompatibilitäts-Docs ansehen

Free-Plan: 3 Repositories, Bis zu 50K indexierte Repo-Zeilen, keine Karte.