Gi en AI-agent kontekst om et stort repo uten en lokal indekser

Et stort repo får ikke plass i et kontekstvindu, og hvis du noen gang har pekt en laptop-indekser mot et ekte monorepo, vet du at det heller ikke får komfortabel plass der — RAM-en skyter i været, den første indekseringen tar en time, og agenten din begynner fortsatt neste økt med å gjette hvilke filer som betyr noe.

Det vanlige svaret er å kjøre en indekser ved siden av editoren, og for et repo som får komfortabel plass på én maskin, er det et godt svar. Hvis monorepoet ditt allerede indekseres raskt i Cursor, og det er det eneste stedet du trenger kartet, har denne teksten ikke noe å tilføye — hopp over den.

Denne teksten handler om det andre tilfellet — når en agent trenger et søkbart kart over et stort repo, og du ikke vil kjøre en lokal indekser for å få det.

Når en lokal indekser er feil verktøy

En lokal indeks forutsetter at koden lever på maskinen som spør den, og i reell monorepo-skala strekker denne antagelsen seg selv innenfor én editor. Repoet er rett og slett større enn du vil holde «varmt» på en laptop: du jobber i én pakke mens påvirkningsradiusen ligger tre kataloger unna, og en første kald indeksering av et to-millioners-linjers tre er ikke noe du vil gjennomgå to ganger — verken på din egen maskin, eller på en CI-runner som aldri har klonet treet før. Eller en kollega burde kunne spørre det samme kartet som deg, uten å vente på at deres egen maskin skal kjempe seg gjennom den samme indekseringen.

Ingenting av dette er en grunn til å kaste en god editor-indekser. Det er en grunn til også å ha et hostet kart som hvilken som helst av agentene dine kan spørre over MCP.

Og skalaproblemet går dypere enn «for mange filer å lime inn». På et stort tre er det interessante spørsmålet nesten aldri «vis meg denne filen» — det er hvilken fil, hvilket symbol, hvilke kallere, hvilke tester. En agent som starter med å liste src/ og lese de tre første treffene, vil muntert overse handleren i apps/api og den genererte klienten i packages/sdk. Det du trenger, er henting bygget fra hele treet, deretter rangert, deretter sitert.

Hva «kontekst om et stort repo» faktisk betyr

Å dumpe filer inn i prompten er ikke kontekst — det er en mindre, dårligere kopi av treet. Det agenten din faktisk trenger, er å stille spørsmål og få siterte svar tilbake: hvor dette symbolet er definert og hvem som kaller det, hva som avhenger av modulen jeg er i ferd med å endre, hvilken testfil som dekker denne oppførselen, og hvordan treet ser ut nå, ikke forrige kvartal.

Disse svarene må komme fra en indeks bygget av ditt repo, ikke fra modellens hukommelse om andres repoer, og indeksen må leve et annet sted enn agentens kontekstvindu. For dette problemet bør den også leve et annet sted enn laptopen din.

Enda én ting instruksjonsfiler ikke kan gjøre for deg: CLAUDE.md og AGENTS.md er riktig sted for konvensjoner og oppførsel, men de er ikke et levende, rangert, søkbart kart over et to-millioners-linjers tre. Bruk regler for oppførsel; bruk repo-intelligens for fakta.

Vi bygger kartet i skyen, spør det fra hvilken som helst klient

Maguyva er et eksternt MCP-lag for kodebase-kontekst. Du kobler til GitHub, velger repoene dine, og kan gå din vei mens sky-pipeliner analyserer treet, bygger symboler og grafkanter, og vedlikeholder et rangert kart — aldri en lokal indekser.

Når du pusher kode, analyseres endrede filer inkrementelt, og graf- og rangeringslagene bygges på nytt etter en tidsplan: daglig på gratisplanen, hver time på betalte planer. Hvert øyeblikksbilde er tidsstemplet, slik at agenten din kan si hvilken versjon av treet den leser. Den ærlige begrensningen her er usynkronisert lokalt arbeid — en endring som bare finnes i arbeidstreet ditt, aldri pushet, er ennå ikke i det hostede kartet.

Deretter kobler du til hvilken som helst klient du allerede bruker, ved å legge en API-nøkkel til MCP-konfigurasjonen. Det finnes oppsettguider for 24 dokumenterte MCP-klienter, og enhver annen MCP-kompatibel klient som støtter standardkonfigurasjon kan også koble til. Hvis Cursor er der du bor, følger Cursor-siden den veien; den samme serveren svarer Claude Code, VS Code, Windsurf, Codex CLI og resten.

Du bytter ikke editor. Du gir agenten din en verktøyflate — 11 MCP-verktøy på tvers av søk, symboler, avhengighetsanalyse, filhenting og repo-kontekst — med dekning på tvers av over 279 språk og tekstbaserte teknologier, noe som betyr mer enn du skulle tro på et monorepo som sluttet å være ett språk for mange år siden.

Svar kommer tilbake underbygget, som filstier med linjenumre. Semantisk, strukturell, graf- og tekstsøk smeltes sammen til rangerte resultater, slik at et spørsmål som «hva avhenger av parseConfig» gir deg verken en grep-dump eller ett enkelt semantisk utdrag, men den håndfullen steder som faktisk betyr noe.

En konkret fremgangsmåte

Ikke start med å indeksere hele selskapet. Her er veien som fungerer:

1. Velg ett repo du allerede kjenner godt — en pakke du kan vurdere for hånd, er verdt mer enn det største treet du har.
2. Start gratis: 3 repoer, 50k indekserte linjer, alle 11 verktøy, ingen månedlig spørrekvote. Hvis det representative repoet ditt er større, lister prissiden opp arbeidsområdenivåene ($0, $19, $49, $149) etter indeksert omfang — ikke etter antall plasser.
3. Koble til GitHub og vent til den første indekseringen er ferdig. Du kompilerer ingenting lokalt.
4. Koble til MCP-klienten — noen få linjer konfigurasjon. Maguyva er en ekstern MCP-server, så det finnes ingen plugins, ingen utvidelser, og ingen andre editor å ta i bruk.
5. Still ett spørsmål du kan verifisere. «Hva avhenger av parseConfig?» eller «Hvor håndteres utløp av innloggingsøkt?» Åpne deretter de siterte file.ext:line-resultatene og sjekk dem mot treet foran deg.
6. Først etter at sitatene overlever den kontakten, lar du agenten redigere.

Hvis det første repoet passer bra og treet ditt er stort, øk arbeidsområdet slik at det matcher indekserte linjer og ombyggingstakt. Mennesker og agenter deler samme brukertall — Maguyva tar betalt per arbeidsområde, ikke per plass — så å legge en tredje agent til løkken koster deg ingenting.

Aktiveringstesten er den samme som dokumentasjonen anbefaler for enhver første kjøring: indekser et repo du allerede kjenner, still ett spørsmål du kan verifisere. Et stort repo endrer ikke testen; det gjør bare en feil første fil dyrere.

Hva du bør følge med på etter tilkobling

Hold øye med tre ting. Friskhet: betalte planer bygger på nytt hver time, gratisplaner daglig, og upushet lokalt arbeid vil ikke være i kartet — det er avveiningen du gjør. Omfang: indekser et representativt sett med repoer, ikke hver arkiverte fork; gratisnivået er bevisst dimensjonert for å finne ut om svarene er verdt å beholde. Og verifisering: et kart over et stort repo som ikke kan sitere stier og linjenumre, er bare en tregere gjettemaskin, så la agenten din vise stedet før den leverer patchen.

Kjør deretter den samme testen du ville kjørt på et lite repo. Indekser et repo du allerede kjenner. Still ett spørsmål du kan verifisere. Hvis kartet er ekte, slutter agenten din å starte fra et kaldt tre.

// no laptop got hot building this map.