# AGENTS.md říká OpenCode vaše pravidla. Maguyva mu ukazuje kód.

Canonical source: https://maguyva.ai/cs/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 čte z AGENTS.md, jak má pracovat, a pro všechno ostatní volá MCP servery. Maguyva je vzdálený MCP server, který dává OpenCode dotazovatelnou mapu vašeho repozitáře s cestami k souborům a čísly řádků.

> Jeden vzdálený záznam pod mcp. Lokálně nic neběží.

## Co potřebujete vědět o OpenCode

Čtyři fakta specifická pro OpenCode.

### opencode.json

Přidejte server pod `mcp` do `opencode.json` projektu, nebo do `~/.config/opencode/opencode.json` pro všechny projekty.

### type: remote

OpenCode se připojuje k endpointu Maguyva přes HTTP. Lokálně nic neběží a Node.js není potřeba.

### Odkaz na proměnnou prostředí

OpenCode dosazuje proměnné prostředí do své konfigurace, takže hlavička zní `Bearer {env:MAGUYVA_API_KEY}` a klíč se nedostane do souboru, který commitujete.

### Omezte ho podle agenta

Každý MCP server přidává do kontextu definice nástrojů. OpenCode umí nástroje serveru globálně vypnout globem jako `"maguyva*": false` a znovu je zapnout jen agentům, kteří je potřebují.

## AGENTS.md je dohoda o spolupráci. Používejte ho.

```text
> /init
# projde repozitář a zapíše AGENTS.md
```

OpenCode čte `AGENTS.md` v kořeni projektu a `~/.config/opencode/AGENTS.md` s osobními pravidly. Bez `AGENTS.md` sáhne po `CLAUDE.md`. Mějte v něm:

- Příkazy pro build, testy a lint.
- Konvence a hranice, které má agent respektovat.
- Odkazy na dokumentaci, na které záleží.

Průchod v okamžiku `/init` je shrnutí, ne index. Neřekne OpenCode, kdo volá funkci přidanou včera.

## Kde AGENTS.md přestává stačit

Tři mezery, které OpenCode zaplňuje grepem a trpělivostí.

### // shrnutí není index

AGENTS.md může jmenovat důležité balíčky. Nevypíše ale každý symbol a místo volání a ani by se o to neměl pokoušet.

### // grep najde řetězce, ne volající

Textová shoda nerozliší skutečné volání od komentáře, mocku nebo stejnojmenné metody jiné třídy.

### // soubor se rozjíždí

AGENTS.md platí v den, kdy vznikl. Kód se dál hýbe a soubor se změní, až si na něj někdo vzpomene.

## Maguyva jako vzdálený MCP server v OpenCode

Jeden záznam pod mcp dá OpenCode:

- **11 nástrojů nad vaším indexovaným repozitářem**: sémantické, strukturální (AST), grafové a textové vyhledávání, plus vyhledávání symbolů, závislé a načítání souborů.
- **Odpovědi s cestami k souborům a čísly řádků**: napříč 285+ jazyky.
- **Stejné odpovědi pro každý model**: OpenCode funguje s mnoha poskytovateli modelů. Maguyva vrací stejnou mapu bez ohledu na to, který model se ptá.

> AGENTS.md říká OpenCode, *jak pracovat*.
> Maguyva dává OpenCode *z čeho vycházet*.

## Dva pracovní postupy

Ptejte se mapy ze stejného terminálu.

### 01. Přejmenujte sdílený typ napříč balíčky

```text
opencode> přejmenuj OrderStatus na FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 odkazů v 8 balíčcích
structural_search(switch_statement, "OrderStatus")
  4 vyčerpávající switche

→ OpenCode upraví celý seznam včetně switchů.
[exit 0]
```

Vyčerpávající switche jsou přesně ta místa, která textové hledání mine a kompilátor zachytí pozdě.

### 02. Rozlište kód od dokumentace

```text
opencode> kde se čte FEATURE_BULK_EXPORT?

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

→ Dvě cesty v kódu, jeden zastaralý dokument.
[exit 0]
```

Přesné shody se vracejí s cestami, takže OpenCode rozliší kód od dokumentace dřív, než něco z toho upraví.

## Nastavení v OpenCode

Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.

### 01. Indexujte repozitář na maguyva.ai

Vyberte si takový, který už znáte, abyste mohli posoudit odpovědi.

### 02. Přidejte Maguyva pod mcp do opencode.json

`opencode.json`

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

### 03. Exportujte klíč a ověřte připojení

Nastavte `MAGUYVA_API_KEY` v shellu, ze kterého spouštíte OpenCode. `opencode mcp list` ukáže každý nakonfigurovaný server; pak položte otázku, na kterou už znáte odpověď.

[Dokumentace MCP](https://opencode.ai/docs/mcp-servers/) v OpenCode popisuje časové limity, OAuth a přístup k nástrojům podle agenta.

## Indexujte jeden repozitář, který už znáte.

Připojte OpenCode přes MCP a položte otázku, kterou si můžete ověřit.