Warp-terminaalin käyttäjille

Warp-terminaalin agentti asuu terminaalissa. Anna sille kartta reposta.

Warp-terminaalin agentti ajaa komentoja ja lukee niiden tulosteen. Maguyva indeksoi koko repon ja tarjoilee sen MCP:n kautta, joten agentti kysyy, missä koodi on, sen sijaan että ajaisi grepiä ja catia, kunnes jokin osuu.

Aloita ilmaiseksi Lue Warp-terminaalin käyttöönotto

Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

Yksi mcpServers-merkintä tiedostossa ~/.warp/.mcp.json: URL ja Authorization-otsake.

Mitä Warp-terminaalin pitää tietää

Neljä Warp-terminaalia koskevaa faktaa.

// asetustiedosto

~/.warp/.mcp.json

Warp käynnistää tämän globaalin tiedoston palvelimet itse. Voit myös liittää saman JSON-määrityksen kohtaan Settings → Agents → MCP servers → + Add.

// siirtotie

Etänä, URL-osoitteella

url-merkintä yhdistää Streamable HTTP:llä tai SSE:llä. Paikallisesti ei ajeta mitään, eikä Node.js:ää tarvita.

// avain

Otsake sellaisenaan

Avain menee suoraan Authorization-otsakkeeseen. Pidä se globaalissa tiedostossa, älä projektin committaamassasi .warp/.mcp.json-tiedostossa.

// projektitiedostot

Ei koskaan automaattisesti käynnissä

Warp tunnistaa kloonatun repon tiedoston .warp/.mcp.json, mutta odottaa, että käynnistät jokaisen palvelimen itse. Kun kytket sen päälle, Warp voi lukea palvelimia myös Claude Code- ja Codex-asetuksista.

Projektisäännöt ovat työskentelysopimus. Käytä niitä.

# AGENTS.md
- Aja make test ennen kuin julistat muutoksen valmiiksi.
- Käytä bin/-hakemiston skriptejä, älä hätäisiä komentoja.

Warp lukee projektisäännöt tiedostosta AGENTS.md (tai WARP.md, joka voittaa, jos molemmat ovat olemassa) ja soveltaa Global Rules -sääntöjä kaikkialla. Käytä niitä näihin:

Build-, testi- ja julkaisukomennot.
Käytännöt, jotka agentti tekee yhä uudelleen väärin.
Komennot, joita agentti ei saa koskaan ajaa.

Säännöt kertovat agentille, miten työskennellä. Ne eivät voi kertoa, mikä palvelu lukee yhä ympäristömuuttujaa, jonka olet poistamassa.

Missä grep terminaalissa loppuu

Kolme asiaa, joita shell-istunto ei opi halvalla.

// tuloste vierii ohi

Jokainen agentin ajama grep ja cat päätyy keskusteluun. Kaksisataa riviä tulostava haku kuluttaa kontekstia ennen kuin varsinainen työ alkaa.

// osuma ei ole kutsuja

grep ei erota oikeaa kutsua kommentista, fixturesta tai toisen luokan samannimisestä metodista.

// shell aloittaa kylmiltään

Uusi istunto ei tiedä reposta mitään. Maguyva-indeksi on jo rakennettu, joten ensimmäinen kysymys saa järjestetyn vastauksen.

Maguyva MCP-palvelimena Warp-terminaalissa

Yksi mcpServers-merkintä antaa Warp-terminaalin agentille:

11 työkalua indeksoituun repoosi semanttinen, rakenteellinen (AST-), graafi- ja tekstihaku sekä symbolihaku, riippuvaiset ja tiedostojen haku.
Vastaukset tiedostopoluilla ja rivinumeroilla yli 285 kielellä, tarpeeksi lyhyinä terminaalin paneelissa luettaviksi.
Työkalut, jotka vain lukevat Maguyva-työkalut kyselevät indeksiä. Mikään niistä ei muokkaa tiedostoja eikä aja komentoja.

Warp antaa agentille terminaalin.
Maguyva antaa agentille kartan koodista.

Kaksi työnkulkua

Kysy ensin kartalta, aja komennot sitten.

// workflow 01

Jäljitä epäonnistuva skripti lähteeseen

warp agent> deploy.sh kaatuu: BUILD_ID puuttuu. missä se asetetaan?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← tekstiä

→ Agentti lataa ci/env.sh:n ja ajaa julkaisun uudelleen.
[exit 0]

Yksi indeksoitu haku korvaa rekursiivisen grepin koko repon läpi ja sen tulosteen.

// workflow 02

Tarkista kutsujat ennen käynnistysvaiheen muuttamista

warp agent> voimmeko lopettaa migraatioiden ajamisen käynnistyksessä?

dependency_search("runMigrations", dependents)
  3 kutsujaa: server.ts, worker.ts, scripts/seed.ts

→ Agentti siirtää kaikki kolme julkaisuvaiheeseen.
[exit 0]

Kutsujat tulevat ennen muutosta, joten worker ei käynnisty vanhaa skeemaa vasten.

Käyttöönotto Warp-terminaalissa

Kolme vaihetta. Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

// step 01

Indeksoi repo osoitteessa maguyva.ai

Valitse jo tuntemasi repo, jotta voit arvioida vastauksia.

// step 02

Lisää Maguyva tiedostoon ~/.warp/.mcp.json

~/.warp/.mcp.json

{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

// step 03

Korvaa paikkamerkki ja kysy yksi kysymys

Korvaa mgv_xxxx omalla API-avaimellasi ja tallenna. Tarkista kohdasta Settings → Agents → MCP servers, että palvelin on käynnissä, ja kysy sitten yksi kysymys, jonka vastauksen jo tiedät.