Přeskočit na obsah

Pro uživatele nástroje Cursor

Cursor edituje soubor.
Maguyva vidí repozitář.

Cursor je editor. V monorepu agent pořád potřebuje mapu toho, který soubor je důležitý. Maguyva indexuje tvou codebase a vrací ji přes MCP (sémantika, AST, graf a text), takže „kde se řeší auth“ vrátí skutečný auth flow, ne sedm testovacích stubů.

Začít zdarmaPřečti si nastavení pro Cursor

Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez karty.

Cursor edituje to, na co ukážeš. Maguyva agentovi řekne, na co má ukázat.

Co dělá každá vrstva

Čtyři části. Každá má svůj úkol.

// editor

Cursor

Kde skutečně programuješ.

// manuální kontext

@ zmínky + piny

Manuální kontext funguje, dokud repozitář nezačne být velký.

// codebase

Maguyva

Automatická fakta o codebase přes MCP.

Cursor je editor. Používej ho.

IDE není problém. Doplňování textu, edit-with-AI, editace více souborů najednou a .cursor/rules v nástroji Cursor jsou skvělé a už je používáš pro:

  • Inline návrhy a edit-with-AI v otevřeném souboru.
  • Editace více souborů, když je změna lokální.
  • .cursor/rules pro konvence repozitáře a stylistická pravidla.
  • @-zmínky, kterými vtáhneš konkrétní soubor do kontextu.

Pokračuj v tom. Nic z toho nezmizí.

Ale ve skutečném monorepu (TypeScript se závislostmi mezi workspaces, Python služby, smíšené balíčky) se agentův kontext rozpadne ve chvíli, kdy relevantní soubor ještě není na tvém radaru.

Manuální opravy, které jsi už zkusil, a kde selhávají

Čtyři manuální opravy spárované se svým selháním. Vlevo = co děláš dnes. Vpravo = kde to selže.

// the fix

// připni soubory

Pomocí @ zmíníš tři soubory, o kterých si myslíš, že jsou důležité. Cursor v nich edituje čistě.

// where it breaks

// připnutí je odhad

Připnutí funguje, když už víš, které soubory jsou zapojené. Celý smysl kontextových nástrojů je ukázat soubory, o kterých jsi nevěděl, že je máš připnout.

// the fix

// vlož úryvky

Vložíš 200 řádků z jiného balíčku do chatu, aby měl agent dost kontextu.

// where it breaks

// vložený kód zastará

Úryvek, který jsi vložil v 9 ráno, neodráží rebase, který kolega odeslal v 11. Agent edituje proti fantomové verzi balíčku.

// the fix

// napiš kontextový dokument

Napíšeš soubor .cursor/rules nebo architektonický markdown. Dnes to sedí.

// where it breaks

// dokumentace zastarává rychleji než kód

Cokoli napíšeš ručně, časem zastará. Kód je zdroj pravdy. Dokument popisující vrstvu fronty je správný tak týden, pak už navždy ne.

// the fix

// nech si soubory s pravidly

Přidáš .cursor/rules pro pojmenování, lint a build příkazy. Skvělé pro chování.

// where it breaks

// pravidla ≠ index

.cursor/rules je správné místo pro „vždy spusť pnpm tsc -b před commitem.“ Není to prohledávatelný index každého symbolu, souboru a místa volání ve tvém monorepu.

Maguyva je vrstva pod tím

Není to náhrada za Cursor. Je to vrstva kontextu repozitáře, která se napojuje na MCP podporu Cursoru.

  • Sémantika + AST + graf + text hledej podle významu, struktury, závislosti nebo doslovného textu. Každý zásah vrátí cestu k souboru a číslo řádku.
  • Napříč balíčky ve výchozím nastavení místa volání a importéry napříč všemi balíčky v monorepu, ne jen tím, co máš zrovna otevřený.
  • Vnímá větve Maguyva vidí tu verzi kódu, kterou Cursor zrovna edituje.
  • Doplňkové, ne konkurenční .cursor/rules dál dělá svou práci. @-zmínky dál dělají svou. Maguyva vyplňuje mezeru, kterou nepokrývají.

Cursor edituje soubor, na který ukážeš.

Maguyva agentovi řekne, na co má ukázat.

Tři workflow napříč monorepem

Napříč balíčky, napříč jazyky. Podložené skutečným grafem volání, ne grepem v nástroji Cursor.

// workflow 01

Najdi auth flow napříč balíčky, aniž bys cokoli připínal

cursor> kde se v tomhle monorepu řeší autentizace?

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 vstupní body napříč 4 balíčky, seřazené podle hustoty míst volání.
[exit 0]

Nepřipnul jsi soubor. Nevložil jsi úryvek. Agent má čtyři důležité soubory, ve správném pořadí, a může udělat podložený edit.

// workflow 02

Najdi skutečnou implementaci, ne testovací stub

cursor> jak normalizePhoneNumber zachází s E.164?

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

Jména lžou. Mocky zastiňují skutečný kód. Maguyva řadí skutečnou implementaci nad testovací mock, napříč každým balíčkem.

// workflow 03

Zkontroluj dosah dopadu, než refaktoruješ

cursor> co volá QueueDispatcher.publish napříč monorepem?

graph::callers(QueueDispatcher.publish)
  3 in packages/billing/*
  1 in packages/audit/*
  1 in packages/notifications/*
  1 in services/python-worker/*  ← napříč jazyky přes gRPC stub
[exit 0]

Cross-package a cross-language, když máte polyglot repo, call-sites povrch inline. Rozdíl je založen na skutečných dovozcích, nikoli na grep Cursor.

Nastavení v nástroji Cursor

Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez karty.

  1. // step 01

    Indexuj repozitář na maguyva.ai

    Vyber monorepo, kde tě kontext bolel nejvíc.

  2. // step 02

    Přidejte Maguyva jako server MCP v nastavení Cursor

    // ~/.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer <your-key>"
      }
    }
  }
}

  3. // step 03

    Polož jednu otázku, jejíž odpověď už znáš

    Nezačínej s celou firmou. Začni jedním repozitářem a jednou ověřitelnou otázkou, třeba „co volá formatInvoice napříč balíčky?“

Samoobslužná registrace je otevřená.

Indexuj jeden repozitář, který už znáš.

Otestuj jednu otázku, jejíž odpověď dokážeš ověřit.

Indexujte svůj první repozitářZobrazit dokumentaci kompatibility

Free plán: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez karty.