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

Canonical source: https://maguyva.ai/sv/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 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.

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

### opencode.json

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

### type: remote

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

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

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

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

### 01. Byt namn på en delad typ över flera paket

```text
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.

### 02. Skilj kod från dokumentation

```text
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.

### 01. Indexera ett repo på maguyva.ai

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

### 02. Lägg till 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. 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å.

OpenCodes [MCP-dokumentation](https://opencode.ai/docs/mcp-servers/) tar upp timeouts, OAuth och verktygsåtkomst per agent.

## Indexera ett repo du redan känner till.

Anslut OpenCode via MCP och ställ en fråga du kan kontrollera.