# AGENTS.md giver OpenCode dine regler. Maguyva viser det koden.

Canonical source: https://maguyva.ai/da/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 læser i AGENTS.md, hvordan det skal arbejde, og kalder MCP-servere til alt andet. Maguyva er en ekstern MCP-server, der giver OpenCode et søgbart kort over dit repo, med filstier og linjenumre.

> Én ekstern post under mcp. Intet kører lokalt.

## Det skal du vide om OpenCode

Fire fakta, der gælder netop OpenCode.

### opencode.json

Tilføj serveren under `mcp` i dit projekts `opencode.json`, eller i `~/.config/opencode/opencode.json` til alle projekter.

### type: remote

OpenCode forbinder til Maguyvas endpoint over HTTP. Intet kører lokalt, og Node.js er ikke nødvendigt.

### En reference til en miljøvariabel

OpenCode erstatter miljøvariabler i sin konfiguration, så headeren lyder `Bearer {env:MAGUYVA_API_KEY}`, og nøglen holdes ude af den fil, du committer.

### Afgræns det per agent

Hver MCP-server føjer værktøjsdefinitioner til konteksten. OpenCode kan slå en servers værktøjer fra globalt med en glob som `"maguyva*": false` og slå dem til igen kun for de agenter, der har brug for dem.

## AGENTS.md er en arbejdsaftale. Brug den.

```text
> /init
# scanner repoet og skriver AGENTS.md
```

OpenCode læser `AGENTS.md` i projektets rod og `~/.config/opencode/AGENTS.md` til personlige regler. Uden en `AGENTS.md` falder det tilbage på `CLAUDE.md`. Brug den til:

- Kommandoer til build, test og lint.
- Konventioner og grænser, agenten skal respektere.
- Henvisninger til den dokumentation, der betyder noget.

En scanning på tidspunktet for `/init` er et resumé, ikke et indeks. Den fortæller ikke OpenCode, hvem der kalder en funktion, der blev tilføjet i går.

## Hvor AGENTS.md slipper op

Tre huller, OpenCode fylder med grep og tålmodighed.

### // et resumé er ikke et indeks

AGENTS.md kan nævne de vigtige pakker. Den kan ikke liste hvert symbol og kaldsted, og den bør ikke prøve.

### // grep finder strenge, ikke kaldere

Et tekstmatch kan ikke skelne et rigtigt kald fra en kommentar, en mock eller en metode med samme navn i en anden klasse.

### // filen sakker bagud

AGENTS.md er rigtig den dag, den bliver skrevet. Koden bliver ved med at flytte sig; filen ændres, når nogen husker det.

## Maguyva som ekstern MCP-server i OpenCode

Én post under mcp giver OpenCode:

- **11 værktøjer til dit indekserede repo**: semantisk, strukturel (AST-), graf- og tekstsøgning, plus symbolopslag, afhængige og filhentning.
- **Svar med filstier og linjenumre**: på tværs af over 285 sprog.
- **Samme svar til alle modeller**: OpenCode arbejder med mange modeludbydere. Maguyva returnerer det samme kort, uanset hvilken model der spørger.

> AGENTS.md fortæller OpenCode, *hvordan det skal arbejde*.
> Maguyva giver OpenCode *noget at arbejde ud fra*.

## To arbejdsgange

Spørg kortet fra den samme terminal.

### 01. Omdøb en delt type på tværs af pakker

```text
opencode> omdøb OrderStatus til FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 referencer i 8 pakker
structural_search(switch_statement, "OrderStatus")
  4 udtømmende switches

→ OpenCode retter hele listen, switches inklusive.
[exit 0]
```

De udtømmende switches er netop dem, en tekstsøgning overser, og som compileren fanger sent.

### 02. Skeln kode fra dokumentation

```text
opencode> hvor læses FEATURE_BULK_EXPORT?

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

→ To kodestier, ét forældet dokument.
[exit 0]
```

Eksakte match kommer tilbage med stier, så OpenCode kan skelne kode fra dokumentation, før det retter i nogen af dem.

## Opsætning i OpenCode

Tre trin. Free-niveau: 3 repos, Op til 50K indekserede repo-linjer, intet kreditkort.

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

Vælg et, du allerede kender, så du kan vurdere svarene.

### 02. Tilføj Maguyva 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 din nøgle, og tjek forbindelsen

Sæt `MAGUYVA_API_KEY` i den shell, der starter OpenCode. `opencode mcp list` viser hver konfigureret server; stil derefter ét spørgsmål, du allerede kender svaret på.

OpenCodes [MCP-dokumentation](https://opencode.ai/docs/mcp-servers/) dækker timeouts, OAuth og værktøjsadgang per agent.

## Indekser ét repo, du allerede kender.

Forbind OpenCode over MCP, og stil ét spørgsmål, du kan tjekke.