Hoppa till innehåll

För OpenCode-användare

AGENTS.md ger OpenCode dina regler.
Maguyva visar det koden.

OpenCode läser i AGENTS.md hur det ska arbeta och anropar MCP-servrar för allt annat. Maguyva är en fjärr-MCP-server som ger OpenCode en sökbar karta över ditt repo, med filsökvägar och radnummer.

Free-nivå: 3 repositorier, Upp till 50K indexerade repo-rader, inget kreditkort krävs.

En fjärrpost under mcp. Inget körs lokalt.

Det här behöver du veta om OpenCode

Fyra fakta som gäller just OpenCode.

// konfigurationsfil

opencode.json

Lägg till servern under mcp i projektets opencode.json, eller i ~/.config/opencode/opencode.json för alla projekt.

// transport

type: remote

OpenCode ansluter till Maguyvas endpoint över HTTP. Inget körs lokalt och Node.js behövs inte.

// nyckel

En referens till en miljövariabel

OpenCode ersätter miljövariabler i sin konfiguration, så headern blir Bearer {env:MAGUYVA_API_KEY} och nyckeln hålls utanför filen du committar.

// kontextbudget

Begränsa per agent

Varje MCP-server lägger till verktygsdefinitioner i kontexten. OpenCode kan stänga av en servers verktyg globalt med en glob som "maguyva*": false och slå på dem igen bara för de agenter som behöver dem.

AGENTS.md är en arbetsöverenskommelse. Använd den.

> /init
# skannar repot och skriver AGENTS.md

OpenCode läser AGENTS.md i projektroten och ~/.config/opencode/AGENTS.md för personliga regler. Utan en AGENTS.md faller det tillbaka på CLAUDE.md. Använd den för:

  • Kommandon för bygge, test och lint.
  • Konventioner och gränser som agenten ska respektera.
  • Pekare till den dokumentation som spelar roll.

En skanning vid /init är en sammanfattning, inte ett index. Den talar inte om för OpenCode vem som anropar en funktion som lades till i går.

Där AGENTS.md inte räcker

Tre luckor som OpenCode fyller med grep och tålamod.

// en sammanfattning är inget index

AGENTS.md kan nämna de viktiga paketen. Den kan inte lista varje symbol och anropsställe, och den bör inte försöka.

// grep hittar strängar, inte anropare

En textträff kan inte skilja ett verkligt anrop från en kommentar, en mock eller en metod med samma namn i en annan klass.

// filen halkar efter

AGENTS.md stämmer den dag den skrivs. Koden fortsätter att röra sig; filen ändras när någon kommer ihåg att uppdatera den.

Maguyva som fjärr-MCP-server i OpenCode

En post under mcp ger OpenCode:

  • 11 verktyg för ditt indexerade repo semantisk, strukturell (AST-), graf- och textsökning, plus symbolsökning, beroenden och filhämtning.
  • Svar med filsökvägar och radnummer över mer än 285 språk.
  • Samma svar för varje modell OpenCode fungerar med många modelleverantörer. Maguyva returnerar samma karta oavsett vilken modell som frågar.

AGENTS.md talar om för OpenCode hur det ska arbeta.

Maguyva ger OpenCode något att arbeta utifrån.

Två arbetsflöden

Fråga kartan från samma terminal.

// workflow 01

Byt namn på en delad typ över flera paket

opencode> byt namn på OrderStatus till FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 referenser i 8 paket
structural_search(switch_statement, "OrderStatus")
  4 uttömmande switchar

→ OpenCode redigerar hela listan, switcharna inräknade.
[exit 0]

De uttömmande switcharna är precis de ställen som en textsökning missar och kompilatorn fångar sent.

// workflow 02

Skilj kod från dokumentation

opencode> var 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   ← bara dokumentation

→ Två kodvägar, ett inaktuellt dokument.
[exit 0]

Exakta träffar kommer tillbaka med sökvägar, så att OpenCode kan skilja kod från dokumentation innan det redigerar något av dem.

Installation i OpenCode

Tre steg. Free-nivå: 3 repositorier, Upp till 50K indexerade repo-rader, inget kreditkort krävs.

  1. // step 01

    Indexera ett repo på maguyva.ai

    Välj ett du redan känner till, så du kan bedöma svaren.

  2. // step 02

    Lägg till 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}"
          }
        }
      }
    }
  3. // step 03

    Exportera nyckeln och kontrollera anslutningen

    Sätt MAGUYVA_API_KEY i skalet som startar OpenCode. opencode mcp list visar varje konfigurerad server; ställ sedan en fråga som du redan vet svaret på.