Přeskočit na obsah

Pro uživatele Gemini CLI

GEMINI.md říká Gemini tvá pravidla.
Ne tvůj kód.

GEMINI.md nastavuje pracovní kontext. MCP umožňuje Gemini sáhnout po nástrojích. Maguyva je MCP server, který Gemini dává prohledávatelnou mapu tvého repozitáře, takže první edit není odhad struktury souborů.

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

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

GEMINI.md je kontext. MCP je kanál. Maguyva je mapa.

Vrstvená architektura

Čtyři myšlenky. Každá dělá jednu věc.

// kontext

GEMINI.md

Jak by se měl Gemini chovat v tomhle repozitáři.

// transport

MCP

Jak Gemini sahá po externích nástrojích a kontextu.

// codebase

Maguyva

MCP server, který vrací podložená fakta o repozitáři.

GEMINI.md je pracovní kontext. Používej ho.

Trvalé instrukce patří do GEMINI.md. Je to správné místo pro:

  • Build, test a lint příkazy, které má Gemini spouštět.
  • Pravidla typu „vždy dělej X / nikdy nedělej Y“, omezená na konkrétní adresář.
  • Konvence pojmenování a preference pro refaktoring.
  • Odkazy na kanonické záznamy rozhodnutí a architektonické poznámky.

Drž to stručné. Ohranič to. Commitni to.

Ale GEMINI.md nikdy nebyl navržený jako prohledávatelný index každého symbolu, souboru a místa volání ve tvém repozitáři.

Kde samotný GEMINI.md dochází

Čtyři selhání, jedno na kartu.

// kontext není index

Říct Gemini, jak má pracovat, mu neřekne, co existuje. První edit v neznámém balíčku je odhad cest k souborům a názvů funkcí. GEMINI.md nemůže vypsat každý symbol, a ani bys to nechtěl.

// dokumentace se odchyluje od kódu

Blok v GEMINI.md popisující topologii tvé fronty je správný, dokud někdo nepřidá nového konzumenta. Kód je teď zdrojem pravdy a dokumentace je sebejistě zastaralá. Gemini čte tu špatnou.

// přejmenování je grafový problém

„Co odkazuje na tuhle třídu?“ se nedá zjistit z markdown souboru. Gemini buď grepuje napříč monorepem a doufá, nebo tě požádá, abys vložil místa volání do chatu.

// kontextová okna nejsou zadarmo

Velké okno není totéž co prohledávatelný index. Načítání GEMINI.md, dokud Gemini „neví dost“, pořád mění rozpočet na uvažování za statický objem kontextu.

Jak tři vrstvy zapadají do sebe

Uživatelé Gemini už takhle přemýšlí. Stránka by to měla jen zviditelnit.

GEMINI.md

kontext

jak se Gemini chová

MCP

kanál

jak sahá po věcech

Maguyva

fakta o codebase

co vidí

  • GEMINI.md jak se Gemini chová v tomhle repozitáři.
  • MCP jak Gemini sahá po nástrojích a kontextu. (specifikace)
  • Maguyva co Gemini vidí, když se codebase na něco zeptá. Sémantické, AST, grafové a textové vyhledávání s cestami k souborům a čísly řádků.

GEMINI.md říká Gemini jak má pracovat.

Maguyva dává Gemini něco, z čeho může vycházet.

Tři workflow

Specifické pro Gemini. Podložené skutečným grafem volání, ne grepem Gemini.

// workflow 01

Přejmenuj sdílenou třídu, nejdřív najdi všechny závislé

gemini> přejmenuj PaymentClient → BillingClient

graph::callers(PaymentClient)            12 odkazů napříč 7 balíčky
graph::importers(src/payments/client.ts)  9 importérů
graph::extends(PaymentClient)             2 podtřídy (RetryClient, MockClient)

→ Gemini navrhuje migraci o 21 editech se seznamem souborů přímo v textu.
[exit 0]

Gemini se Maguyva zeptá na závislosti předtím, než začne editovat. Seznam migrace se vrátí podložený skutečným grafem, ne Geminiho vzpomínkou.

// workflow 02

Najdi skutečnou implementaci, ne testovací stub

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

semantic::query("normalize phone E.164")
  src/util/phone.ts:88   normalizePhoneNumber()   ← skutečná impl
  test/util/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.

// workflow 03

Zkontroluj dosah dopadu před refaktoringem

gemini> co volá QueueDispatcher.publish?

graph::callers(QueueDispatcher.publish)
  3 in src/billing/*    1 in src/audit/*    1 in src/notifications/*
[exit 0]

Místa volání napříč balíčky se objeví přímo v textu. Diff je podložený skutečnými importéry, ne grepem Gemini.

Nastavení v Gemini CLI

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 si repozitář, který dobře znáš, abys mohl ověřit odpovědi.

  2. // step 02

    Přidej Maguyva jako MCP server do nastavení Gemini CLI

    // ~/.gemini/settings.json
{
  "mcpServers": {
    "maguyva": {
      "httpUrl": "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.

Samoobslužná registrace je otevřená.

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

Připoj Gemini přes MCP. Polož 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.