# AGENTS.md vertelt OpenCode je regels. Maguyva laat het de code zien.

Canonical source: https://maguyva.ai/nl/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 leest in AGENTS.md hoe het moet werken en roept voor al het andere MCP-servers aan. Maguyva is een remote MCP-server die OpenCode een doorzoekbare kaart van je repo geeft, met bestandspaden en regelnummers.

> Eén remote entry onder mcp. Lokaal draait er niets.

## Wat je over OpenCode moet weten

Vier feiten die specifiek zijn voor OpenCode.

### opencode.json

Voeg de server toe onder `mcp` in de `opencode.json` van je project, of in `~/.config/opencode/opencode.json` voor al je projecten.

### type: remote

OpenCode maakt via HTTP verbinding met het endpoint van Maguyva. Lokaal draait er niets en Node.js is niet nodig.

### Een verwijzing naar een omgevingsvariabele

OpenCode vult omgevingsvariabelen in zijn config in, dus de header luidt `Bearer {env:MAGUYVA_API_KEY}` en de sleutel blijft buiten het bestand dat je commit.

### Beperk het per agent

Elke MCP-server voegt tooldefinities toe aan de context. OpenCode kan de tools van een server globaal uitzetten met een glob als `"maguyva*": false` en ze alleen weer aanzetten voor de agents die ze nodig hebben.

## AGENTS.md is een werkafspraak. Gebruik het.

```text
> /init
# scant de repo en schrijft AGENTS.md
```

OpenCode leest `AGENTS.md` in de projectroot en `~/.config/opencode/AGENTS.md` voor persoonlijke regels. Zonder `AGENTS.md` valt het terug op `CLAUDE.md`. Gebruik het voor:

- Build-, test- en lintcommando’s.
- Conventies en grenzen die de agent moet respecteren.
- Verwijzingen naar de documentatie die ertoe doet.

Een scan op het moment van `/init` is een samenvatting, geen index. Hij vertelt OpenCode niet wie een functie aanroept die gisteren is toegevoegd.

## Waar AGENTS.md tekortschiet

Drie gaten die OpenCode vult met grep en geduld.

### // een samenvatting is geen index

AGENTS.md kan de belangrijke pakketten noemen. Het kan niet elk symbool en elke aanroepplek opsommen, en dat moet het ook niet proberen.

### // grep vindt strings, geen aanroepers

Een tekstmatch kan een echte aanroep niet onderscheiden van een comment, een mock of een gelijknamige methode in een andere klasse.

### // het bestand loopt achter

AGENTS.md klopt op de dag dat het is geschreven. De code blijft bewegen; het bestand verandert als iemand eraan denkt.

## Maguyva als remote MCP-server in OpenCode

Eén entry onder mcp geeft OpenCode:

- **11 tools voor je geïndexeerde repo**: semantisch, structureel (AST-), graaf- en tekstzoeken, plus symbolen opzoeken, afhankelijken en bestanden ophalen.
- **Antwoorden met bestandspaden en regelnummers**: over meer dan 285 talen.
- **Dezelfde antwoorden voor elk model**: OpenCode werkt met veel modelproviders. Maguyva levert dezelfde kaart, welk model ook vraagt.

> AGENTS.md vertelt OpenCode *hoe het moet werken*.
> Maguyva geeft OpenCode *iets om mee te werken*.

## Twee workflows

Vraag de kaart vanuit dezelfde terminal.

### 01. Hernoem een gedeeld type over pakketten heen

```text
opencode> hernoem OrderStatus naar FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 verwijzingen in 8 pakketten
structural_search(switch_statement, "OrderStatus")
  4 uitputtende switches

→ OpenCode bewerkt de volledige lijst, switches inbegrepen.
[exit 0]
```

De uitputtende switches zijn precies de plekken die tekstzoeken mist en de compiler pas laat vangt.

### 02. Onderscheid code van documentatie

```text
opencode> waar wordt FEATURE_BULK_EXPORT gelezen?

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

→ Twee codepaden, één verouderd document.
[exit 0]
```

Exacte matches komen terug met paden, zodat OpenCode code van documentatie kan onderscheiden voordat het een van beide bewerkt.

## Instellen in OpenCode

Drie stappen. Free-abonnement: 3 repositories, Tot 50K geïndexeerde repo-regels, geen creditcard nodig.

### 01. Indexeer een repo op maguyva.ai

Kies er een die je al kent, zodat je de antwoorden kunt beoordelen.

### 02. Voeg Maguyva toe onder mcp in opencode.json

`opencode.json`

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

### 03. Exporteer je sleutel en controleer de verbinding

Zet `MAGUYVA_API_KEY` in de shell waarmee je OpenCode start. `opencode mcp list` toont elke geconfigureerde server; stel daarna één vraag waarvan je het antwoord al weet.

De [MCP-documentatie](https://opencode.ai/docs/mcp-servers/) van OpenCode behandelt timeouts, OAuth en tooltoegang per agent.

## Indexeer één repo die je al kent.

Verbind OpenCode via MCP en stel één vraag die je kunt controleren.