For OpenCode-brukere

AGENTS.md gir OpenCode reglene dine.
Maguyva viser det koden.

OpenCode leser i AGENTS.md hvordan det skal jobbe, og kaller MCP-servere for alt annet. Maguyva er en ekstern MCP-server som gir OpenCode et søkbart kart over repoet ditt, med filstier og linjenumre.

Start gratis Les OpenCode-oppsettet

Free-planen: 3 repoer, Opptil 50K indekserte kodelinjer, uten kredittkort.

Én ekstern oppføring under mcp. Ingenting kjører lokalt.

Dette må du vite om OpenCode

Fire fakta som gjelder akkurat OpenCode.

// konfigurasjonsfil

opencode.json

Legg til serveren under mcp i prosjektets opencode.json, eller i ~/.config/opencode/opencode.json for alle prosjekter.

// transport

type: remote

OpenCode kobler seg til Maguyvas endepunkt over HTTP. Ingenting kjører lokalt, og Node.js trengs ikke.

// nøkkel

En referanse til en miljøvariabel

OpenCode setter inn miljøvariabler i konfigurasjonen sin, så headeren lyder Bearer {env:MAGUYVA_API_KEY}, og nøkkelen holdes utenfor filen du committer.

// kontekstbudsjett

Avgrens det per agent

Hver MCP-server legger verktøydefinisjoner til konteksten. OpenCode kan slå av en servers verktøy globalt med en glob som "maguyva*": false og slå dem på igjen bare for agentene som trenger dem.

AGENTS.md er en samarbeidsavtale. Bruk den.

> /init
# skanner repoet og skriver AGENTS.md

OpenCode leser AGENTS.md i prosjektroten og ~/.config/opencode/AGENTS.md for personlige regler. Uten en AGENTS.md faller det tilbake på CLAUDE.md. Bruk den til:

Kommandoer for bygg, test og lint.
Konvensjoner og grenser agenten skal respektere.
Pekere til dokumentasjonen som betyr noe.

En skanning ved /init er et sammendrag, ikke en indeks. Den forteller ikke OpenCode hvem som kaller en funksjon som ble lagt til i går.

Der AGENTS.md kommer til kort

Tre hull OpenCode fyller med grep og tålmodighet.

// et sammendrag er ikke en indeks

AGENTS.md kan nevne de viktige pakkene. Den kan ikke liste hvert symbol og kallsted, og den bør ikke prøve.

// grep finner strenger, ikke kallere

Et teksttreff kan ikke skille et ekte kall fra en kommentar, en mock eller en metode med samme navn i en annen klasse.

// filen henger etter

AGENTS.md stemmer den dagen den blir skrevet. Koden fortsetter å bevege seg; filen endres når noen husker det.

Maguyva som ekstern MCP-server i OpenCode

Én oppføring under mcp gir OpenCode:

11 verktøy for det indekserte repoet ditt semantisk, strukturelt (AST-), graf- og tekstsøk, pluss symboloppslag, avhengige og filhenting.
Svar med filstier og linjenumre på tvers av over 285 språk.
Samme svar for alle modeller OpenCode fungerer med mange modelleverandører. Maguyva returnerer det samme kartet, uansett hvilken modell som spør.

AGENTS.md forteller OpenCode hvordan det skal jobbe.
Maguyva gir OpenCode noe å jobbe ut fra.

To arbeidsflyter

Spør kartet fra den samme terminalen.

// workflow 01

Gi en delt type nytt navn på tvers av pakker

opencode> gi OrderStatus nytt navn til FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 referanser i 8 pakker
structural_search(switch_statement, "OrderStatus")
  4 uttømmende switcher

→ OpenCode redigerer hele listen, switchene inkludert.
[exit 0]

De uttømmende switchene er nettopp de stedene et tekstsøk overser og kompilatoren fanger sent.

// workflow 02

Skill kode fra dokumentasjon

opencode> hvor leses FEATURE_BULK_EXPORT?

text_pattern_search("FEATURE_BULK_EXPORT")
  src/config/flags.ts:17
  src/export/bulk.ts:5
  docs/flags.md:40   ← bare dokumentasjon

→ To kodestier, ett utdatert dokument.
[exit 0]

Eksakte treff kommer tilbake med stier, så OpenCode kan skille kode fra dokumentasjon før det redigerer noen av dem.

Oppsett i OpenCode

Tre steg. Free-planen: 3 repoer, Opptil 50K indekserte kodelinjer, uten kredittkort.

// step 01

Indekser et repo på maguyva.ai

Velg ett du allerede kjenner, så du kan vurdere svarene.

// step 02

Legg Maguyva til under mcp i opencode.json

opencode.json

{
  "mcp": {
    "maguyva": {
      "type": "remote",
      "url": "https://maguyva.tools/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 03

Eksporter nøkkelen og sjekk tilkoblingen

Sett MAGUYVA_API_KEY i skallet som starter OpenCode. opencode mcp list viser hver konfigurerte server; still deretter ett spørsmål du allerede vet svaret på.