Voor OpenCode-gebruikers

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

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.

Start gratis Lees de OpenCode-setup

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

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

Wat je over OpenCode moet weten

Vier feiten die specifiek zijn voor OpenCode.

// configbestand

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.

// transport

type: remote

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

// sleutel

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.

// contextbudget

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.

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

// workflow 01

Hernoem een gedeeld type over pakketten heen

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.

// workflow 02

Onderscheid code van documentatie

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.

// step 01

Indexeer een repo op maguyva.ai

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

// step 02

Voeg Maguyva toe onder mcp in opencode.json

opencode.json

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

// step 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.