Pagbibigay sa AI coding agent ng konteksto ng malaking repo nang walang local indexer

Hindi kasya sa context window ang malalaking repository, at kung ituro mo na ang isang laptop-based na indexer sa isang tunay na monorepo, alam mong hindi rin ito kasya nang komportable doon — tumataas ang RAM, umaabot ng isang oras ang unang pag-index, at nagsisimula pa rin ang agent mo ng susunod na session sa pamamagitan ng pag-hula kung aling mga file ang mahalaga.

Ang karaniwang sagot ay magpatakbo ng indexer sa tabi ng editor, at para sa isang repo na komportableng kasya sa isang makina, magandang sagot iyan. Kung mabilis nang nag-i-index ang monorepo mo sa Cursor at doon lamang kailangan mo ng mapa, wala nang idadagdag ang artikulong ito — laktawan na lang.

Tungkol ang artikulong ito sa ibang kaso — kapag kailangan ng agent ng mapang maaaring i-cite ng isang malaking repo, at ayaw mong magpatakbo ng local indexer para makuha iyon.

Kailan nagiging maling tool ang local indexer

Ang local index ay ipinapalagay na naninirahan ang code sa parehong makina na nagtatanong dito, at sa sukat ng tunay na monorepo, humihigpit ang palagay na iyan kahit sa loob mismo ng isang editor. Ang repo ay simpleng mas malaki lang kaysa sa gusto mong panatilihing ‘mainit’ sa laptop: nagtatrabaho ka sa isang package habang ang saklaw ng epekto ay tatlong directory ang layo, at ang unang cold indexing ng isang two-million-line na tree ay hindi bagay na gustong daanan mo nang dalawang beses — makina mo man o sa isang CI runner na hindi pa kailanman nag-clone sa tree na iyon. O dapat kayang magtanong ng katrabaho sa parehong mapa gaya ng itinatanong mo, nang hindi hinihintay na hirapan ng sariling makina nila ang parehong index.

Walang alinman dito ang dahilan para itapon ang isang mahusay na editor indexer. Ito ay dahilan para magkaroon din ng hosted map na maaaring itanong ng alinmang agent mo sa pamamagitan ng MCP.

At ang problemang iyon sa sukat ay mas malalim kaysa sa ‘sobrang daming file para i-paste’. Sa isang malaking tree, ang kawili-wiling tanong ay halos hindi kailanman ‘ipakita mo sa akin ang file na ito’ — ito ay aling file, aling symbol, sino ang tumatawag, aling test. Ang agent na nagsisimula sa pag-list ng src/ at pagbasa ng unang tatlong resulta ay masayang makakaligtaan ang handler sa apps/api at ang na-generate na client sa packages/sdk. Ang kailangan mo ay retrieval na binuo mula sa buong tree, pagkatapos ay ranked, pagkatapos ay cited.

Ano talaga ang ibig sabihin ng ‘konteksto ng malaking repo’

Hindi konteksto ang pagbuhos ng mga file sa prompt — ito ay isang mas maliit at mas masamang kopya ng tree. Ang tunay na kailangan ng agent mo ay ang magtanong at makakuha ng cited na sagot pabalik: saan tinukoy ang symbol na ito at sino ang tumatawag dito, ano ang umaasa sa module na papalitan ko, aling test file ang sumasaklaw sa asal na ito, at ano ang hitsura ng tree na iyon ngayon, hindi noong nakaraang quarter.

Dapat manggaling ang mga sagot na iyon sa isang index na binuo mula sa repo mo, hindi sa alaala ng modelo tungkol sa repo ng iba, at dapat naninirahan ang index na iyon sa isang lugar sa labas ng context window ng agent. Para sa problemang ito, dapat din itong naninirahan sa isang lugar sa labas ng iyong laptop.

Isa pang bagay na hindi kayang gawin sa iyo ng mga instruction file: ang tamang lugar para sa mga convention at asal ay ang CLAUDE.md at AGENTS.md, ngunit hindi ito buhay, ranked, at itatanong na mapa ng two-million-line na tree. Gamitin ang mga panuntunan para sa asal; gamitin ang repo intelligence para sa mga katotohanan.

Binubuo namin ang mapa sa cloud, itinatanong mo ito mula sa alinmang client

Ang Maguyva ay isang remote MCP codebase context layer. Ikonekta mo ang GitHub, piliin ang repo mo, at maaari kang lumakad palayo habang pinapa-parse ng cloud pipeline ang tree, binubuo ang mga symbol at graph edge, at pinapanatili ang ranked na mapa — hindi kailanman kailangan ng local indexer.

Kapag nag-push ka ng code, ang mga nagbagong file ay incrementally pa-parse, at ang graph at ranking layer ay muling binubuo ayon sa iskedyul: araw-araw sa libreng plano, bawat oras sa mga bayad na plano. May timestamp ang bawat snapshot, para malaman ng agent mo kung aling bersyon ng tree ang binabasa nito. Ang tapat na limitasyon dito ay ang unsynced na local work — ang mga pagbabagong umiiral lamang sa working tree mo, hindi kailanman naipush, ay wala pa sa hosted map.

Pagkatapos, ikonekta mo ang alinmang client na ginagamit mo na sa pamamagitan ng pagdadagdag ng API key sa MCP config nito. May mga setup guide para sa 24 dokumentadong MCP client, at maaari ring kumonekta ang alinmang ibang MCP-compatible client na sumusuporta sa standard na configuration. Kung Cursor ang tinitirhan mo, ang Cursor page ang nagmamapa ng daanang iyon; ang parehong server ay sumasagot sa Claude Code, VS Code, Windsurf, Codex CLI, at iba pa.

Hindi ka nagpapalit ng editor. Binibigyan mo ang agent mo ng tool surface — 11 MCP tool sa search, symbol, dependency analysis, file retrieval, at repository context — na may coverage na mahigit 279 wika at teknolohiyang text-based, na ibig sabihin ay higit pa sa akala mo para sa isang monorepo na matagal nang hindi na isang wika lamang.

Bumabalik ang mga sagot na naka-ground, bilang mga file path na may line number. Ang semantic, structural, graph, at text search ay nagsasama sa isang ranked na resulta, para ang tanong tulad ng ‘ano ang umaasa sa parseConfig’ ay hindi lang nagbibigay sa iyo ng tambak ng grep o iisang semantic cited, kundi ang ilang lugar na tunay na mahalaga.

Isang konkretong gabay

Huwag simulan ang buong kumpanya. Ito ang daan na gumagana:

1. Pumili ng isang repository na kilala mo nang mabuti — ang isang package na kaya mong husgahan nang manu-mano ay mas mahalaga kaysa sa pinakamalaking tree na mayroon ka.
2. Magsimula nang libre: 3 repo, 50 libong naka-index na linya, lahat ng 11 tool, walang buwanang query quota. Kung mas malaki ang kinatawang repo mo, inilista ng pricing page ang mga workspace tier ($0, $19, $49, $149) ayon sa naka-index na coverage — hindi ayon sa bilang ng seat.
3. Ikonekta ang GitHub at hintayin matapos ang unang pag-index. Hindi ka nag-co-compile ng anuman nang local.
4. Ikonekta ang MCP client mo — ilang linya ng config. Ang Maguyva ay isang remote MCP server, kaya walang plugin, walang extension, at walang ikalawang editor na aampunin.
5. Magtanong ng isang tanong na kaya mong ma-verify. ‘Ano ang umaasa sa parseConfig?’ o ‘Saan hinahawakan ang login session expiry?’ Pagkatapos buksan ang cited na resulta ng file.ext:line at i-check laban sa tree na nasa harap mo.
6. Pagkatapos lang na manatili ang cited sa paglapat sa tree na iyon, pahihintulutan mo ang agent na mag-edit.

Kung mahusay na kumasya ang unang repo at malaki ang tree mo, i-upgrade ang workspace para tumugma sa naka-index mong linya at rebuild rate. Nagbabahagi ang tao at agent ng parehong bilang ng user — ang Maguyva ay singil bawat workspace, hindi bawat seat — kaya ang pagdaragdag ng ikatlong agent sa loop ay hindi ka nagkakahalaga ng dagdag na anuman.

Ang activation test ay pareho sa inirerekomenda ng dokumentasyon para sa alinmang unang pagpapatakbo: i-index ang repo na kilala mo na, magtanong ng isang tanong na kaya mong ma-verify. Hindi binabago ng malaking repo ang pagsubok na iyon; pinapamahal lang nito ang unang maling file.

Ano ang dapat panoorin matapos kumonekta

Panoorin ang tatlong bagay. Freshness: nire-rebuild bawat oras ang mga bayad na plano, araw-araw ang libreng plano, at ang unpushed na local work ay hindi mapapasama sa mapa — iyan ang trade-off na tinatanggap mo. Saklaw: i-index ang isang kinatawang set ng mga repo, hindi bawat archived na fork; ang libreng tier ay sadyang ginawang maliit para malaman kung sulit itago ang mga sagot. At pag-verify: ang mapa ng malaking repo na hindi kayang mag-cite ng path at line number ay isang mas mabagal na guessing engine lamang, kaya patunayan ng agent mo ang mga lokasyon bago magpadala ng patch.

Pagkatapos patakbuhin ang parehong pagsubok na papatakbuhin mo sa isang maliit na repo. I-index ang repo na kilala mo na. Magtanong ng isang tanong na kaya mong ma-verify. Kung tama ang mapa, hihinto ang agent mo sa pagsisimula mula sa isang malamig na tree.

// no laptop got hot building this map.