Til OpenCode-brugere

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

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.

Start gratis Læs OpenCode-opsætningen

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

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

Det skal du vide om OpenCode

Fire fakta, der gælder netop OpenCode.

// konfigurationsfil

opencode.json

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

// transport

type: remote

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

// nøgle

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.

// kontekstbudget

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.

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

// workflow 01

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

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.

// workflow 02

Skeln kode fra dokumentation

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.

// step 01

Indekser et repo på maguyva.ai

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

// step 02

Tilføj Maguyva 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 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å.