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

Canonical source: https://maguyva.ai/nb/for-opencode

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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.

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

## Dette må du vite om OpenCode

Fire fakta som gjelder akkurat OpenCode.

### opencode.json

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

### type: remote

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

### 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.

### 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.

```text
> /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.

### 01. Gi en delt type nytt navn på tvers av pakker

```text
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.

### 02. Skill kode fra dokumentasjon

```text
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.

### 01. Indekser et repo på maguyva.ai

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

### 02. Legg Maguyva til under mcp i opencode.json

`opencode.json`

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

### 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å.

[MCP-dokumentasjonen](https://opencode.ai/docs/mcp-servers/) til OpenCode dekker tidsavbrudd, OAuth og verktøytilgang per agent.

## Indekser ett repo du allerede kjenner.

Koble OpenCode til over MCP, og still ett spørsmål du kan sjekke.