OpenCode-käyttäjille

AGENTS.md kertoo OpenCode-agentille säännöt.
Maguyva näyttää sille koodin.

OpenCode lukee tiedostosta AGENTS.md, miten työskennellä, ja kutsuu kaikkeen muuhun MCP-palvelimia. Maguyva on etä-MCP-palvelin, joka antaa OpenCode-agentille kyseltävän kartan repostasi tiedostopolkuineen ja rivinumeroineen.

Aloita ilmaiseksi Lue OpenCode-asennus

Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

Yksi etämerkintä mcp-kohtaan. Paikallisesti ei ajeta mitään.

Mitä OpenCode-agentista pitää tietää

Neljä OpenCode-agentille ominaista asiaa.

// asetustiedosto

opencode.json

Lisää palvelin kohtaan mcp projektin tiedostossa opencode.json, tai kaikille projekteille tiedostoon ~/.config/opencode/opencode.json.

// siirto

type: remote

OpenCode yhdistää Maguyva-päätepisteeseen HTTP:n yli. Paikallisesti ei ajeta mitään, eikä Node.js:ää tarvita.

// avain

Viittaus ympäristömuuttujaan

OpenCode korvaa ympäristömuuttujat asetuksissaan, joten otsake on muotoa Bearer {env:MAGUYVA_API_KEY}, eikä avain päädy tiedostoon, jonka commitoit.

// kontekstibudjetti

Rajaa agenttikohtaisesti

Jokainen MCP-palvelin lisää kontekstiin työkalumäärittelyjä. OpenCode voi kytkeä palvelimen työkalut pois globaalisti globilla kuten "maguyva*": false ja takaisin päälle vain niille agenteille, jotka niitä tarvitsevat.

AGENTS.md on työskentelysopimus. Käytä sitä.

> /init
# skannaa repon ja kirjoittaa AGENTS.md:n

OpenCode lukee tiedoston AGENTS.md projektin juuresta ja henkilökohtaiset säännöt tiedostosta ~/.config/opencode/AGENTS.md. Jos AGENTS.md puuttuu, se käyttää tiedostoa CLAUDE.md. Pidä siinä:

Build-, testi- ja lint-komennot.
Käytännöt ja rajat, joita agentin pitää noudattaa.
Viittaukset olennaiseen dokumentaatioon.

Komennon /init aikainen skannaus on yhteenveto, ei indeksi. Se ei kerro OpenCode-agentille, kuka kutsuu eilen lisättyä funktiota.

Missä AGENTS.md ei enää riitä

Kolme aukkoa, jotka OpenCode paikkaa grepillä ja kärsivällisyydellä.

// yhteenveto ei ole indeksi

AGENTS.md voi nimetä tärkeät paketit. Se ei voi luetella jokaista symbolia ja kutsukohtaa, eikä sen pitäisi yrittääkään.

// grep löytää merkkijonoja, ei kutsujia

Tekstiosuma ei erota todellista kutsua kommentista, mockista tai toisen luokan samannimisestä metodista.

// tiedosto jää jälkeen

AGENTS.md pitää paikkansa sinä päivänä, kun se kirjoitetaan. Koodi liikkuu eteenpäin; tiedosto muuttuu, kun joku muistaa päivittää sen.

Maguyva etä-MCP-palvelimena OpenCode-agentissa

Yksi mcp-kohdan merkintä antaa OpenCode-agentille:

11 työkalua indeksoituun repoosi semanttinen, rakenteellinen (AST-), graafi- ja tekstihaku sekä symbolihaku, riippuvaiset ja tiedostojen haku.
Vastaukset tiedostopoluilla ja rivinumeroilla yli 285 kielellä.
Samat vastaukset jokaiselle mallille OpenCode toimii monien mallitarjoajien kanssa. Maguyva palauttaa saman kartan riippumatta siitä, mikä malli kysyy.

AGENTS.md kertoo OpenCode-agentille, miten työskennellä.
Maguyva antaa OpenCode-agentille jotain, mistä lähteä liikkeelle.

Kaksi työnkulkua

Kysy kartalta samassa päätteessä.

// workflow 01

Nimeä jaettu tyyppi uudelleen pakettien yli

opencode> nimeä OrderStatus uudelleen muotoon FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 viittausta 8 paketissa
structural_search(switch_statement, "OrderStatus")
  4 kattavaa switch-lausetta

→ OpenCode muokkaa koko listan switch-lauseet mukaan lukien.
[exit 0]

Kattavat switch-lauseet ovat juuri ne kohdat, jotka tekstihaku ohittaa ja kääntäjä huomaa myöhään.

// workflow 02

Erota koodi dokumentaatiosta

opencode> missä FEATURE_BULK_EXPORT luetaan?

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

→ Kaksi koodipolkua, yksi vanhentunut dokumentti.
[exit 0]

Tarkat osumat palaavat polkuineen, joten OpenCode erottaa koodin dokumentaatiosta ennen kuin muokkaa kumpaakaan.

Asennus OpenCode-agentissa

Kolme vaihetta. Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

// step 01

Indeksoi repo osoitteessa maguyva.ai

Valitse jo tuntemasi repo, jotta voit arvioida vastauksia.

// step 02

Lisää Maguyva opencode.json-tiedoston mcp-kohtaan

opencode.json

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

// step 03

Vie avain ympäristöön ja tarkista yhteys

Aseta MAGUYVA_API_KEY siinä kuoressa, josta käynnistät OpenCode-agentin. opencode mcp list näyttää jokaisen määritetyn palvelimen; kysy sitten yksi kysymys, jonka vastauksen jo tiedät.