Para sa mga user ng OpenCode

Sinasabi ng AGENTS.md sa OpenCode ang mga rule mo.
Ipinapakita ng Maguyva ang code.

Binabasa ng OpenCode ang AGENTS.md para sa paraan ng pagtatrabaho at tumatawag ito sa mga MCP server para sa lahat ng iba pa. Ang Maguyva ay remote MCP server na nagbibigay sa OpenCode ng mapa ng repo mo na puwedeng i-query, may file path at line number.

Magsimula nang libre Basahin ang setup sa OpenCode

May Free tier: 3 repository, Hanggang 50K na naka-index na linya ng repo, walang card.

Isang remote entry sa ilalim ng mcp. Walang tumatakbo nang local.

Ang kailangang malaman tungkol sa OpenCode

Apat na fact na partikular sa OpenCode.

// config file nito

opencode.json

Idagdag ang server sa ilalim ng mcp sa opencode.json ng project mo, o sa ~/.config/opencode/opencode.json para sa lahat ng project.

// paraan ng koneksyon

type: remote

Kumokonekta ang OpenCode sa endpoint ng Maguyva sa pamamagitan ng HTTP. Walang tumatakbo nang local at hindi kailangan ng Node.js.

// ang key

Isang env reference

Pinapalitan ng OpenCode ang mga environment variable sa config nito, kaya Bearer {env:MAGUYVA_API_KEY} ang laman ng header at hindi napapasama ang key sa file na kino-commit mo.

// budget ng context

I-scope ito kada agent

Nagdadagdag ng mga tool definition sa context ang bawat MCP server. Kayang i-off ng OpenCode ang mga tool ng isang server globally gamit ang glob gaya ng "maguyva*": false at i-on ulit para sa mga agent na nangangailangan nito.

Working agreement ang AGENTS.md. Gamitin ito.

> /init
# ini-scan ang repo at isinusulat ang AGENTS.md

Binabasa ng OpenCode ang AGENTS.md sa project root at ang ~/.config/opencode/AGENTS.md para sa personal na rules. Kapag walang AGENTS.md, bumabalik ito sa CLAUDE.md. Gamitin ito para sa:

Mga build, test, at lint command.
Mga convention at hangganan na dapat igalang ng agent.
Mga pointer sa mahahalagang dokumento.

Summary ang scan sa /init, hindi index. Hindi nito sinasabi sa OpenCode kung sino ang tumatawag sa function na idinagdag kahapon.

Kapag kulang na ang AGENTS.md

Tatlong puwang na pinupunan ng OpenCode gamit ang grep at pasensya.

// hindi index ang summary

Kayang pangalanan ng AGENTS.md ang mahahalagang package. Hindi nito kayang ilista ang bawat symbol at call site, at hindi rin dapat subukan.

// string ang nahahanap ng grep, hindi caller

Hindi kayang ihiwalay ng text match ang totoong call sa isang comment, isang mock, o isang method na may parehong pangalan sa ibang class.

// naiiwan ang file

Tama ang AGENTS.md sa araw na isinulat ito. Patuloy na gumagalaw ang code; nagbabago lang ang file kapag may nakaalalang mag-update.

Maguyva bilang remote MCP server sa OpenCode

Ang isang entry sa ilalim ng mcp ay nagbibigay sa OpenCode ng:

11 na tool sa naka-index mong repo semantic, structural (AST), graph, at text search, kasama ang symbol lookup, mga dependent, at pagkuha ng file.
Mga sagot na may file path at line number sa 285+ na wika.
Parehong sagot para sa bawat model Gumagana ang OpenCode sa maraming model provider. Iisang mapa ang ibinabalik ng Maguyva kahit aling model ang magtanong.

Sinasabi ng AGENTS.md sa OpenCode kung paano magtrabaho.
Binibigyan ng Maguyva ang OpenCode ng isang bagay na pagbabatayan.

Dalawang workflow

Tanungin ang mapa mula sa parehong terminal.

// workflow 01

Palitan ang pangalan ng isang shared type sa iba't ibang package

opencode> palitan ang pangalan ng OrderStatus at gawing FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 reference sa 8 na package
structural_search(switch_statement, "OrderStatus")
  4 na exhaustive switch

→ Ine-edit ng OpenCode ang buong listahan, kasama ang mga switch.
[exit 0]

Ang mga exhaustive switch ang nalalampasan ng text search at huli nang nahuhuli ng compiler.

// workflow 02

Ihiwalay ang code sa dokumentasyon

opencode> saan binabasa ang FEATURE_BULK_EXPORT?

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

→ Dalawang code path, isang lumang doc.
[exit 0]

Bumabalik ang mga eksaktong tugma kasama ang path, kaya naihihiwalay ng OpenCode ang code sa dokumentasyon bago nito i-edit ang alinman.

Setup sa OpenCode

Tatlong hakbang. Free tier: 3 repository, Hanggang 50K na naka-index na linya ng repo, walang card.

// step 01

I-index ang isang repo sa maguyva.ai

Pumili ng isang alam mo na, para masuri mo ang mga sagot.

// step 02

Idagdag ang Maguyva sa ilalim ng mcp sa opencode.json

opencode.json

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

// step 03

I-export ang key mo at tsekin ang koneksyon

I-set ang MAGUYVA_API_KEY sa shell na nagsisimula sa OpenCode. Ipinapakita ng opencode mcp list ang bawat naka-configure na server; pagkatapos ay magtanong ng isang bagay na alam mo na ang sagot.