# Sinasabi ng AGENTS.md sa OpenCode ang mga rule mo. Ipinapakita ng Maguyva ang code. Canonical source: https://maguyva.ai/fil/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). 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. > Isang remote entry sa ilalim ng mcp. Walang tumatakbo nang local. ## Ang kailangang malaman tungkol sa OpenCode Apat na fact na partikular sa OpenCode. ### 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. ### type: remote Kumokonekta ang OpenCode sa endpoint ng Maguyva sa pamamagitan ng HTTP. Walang tumatakbo nang local at hindi kailangan ng Node.js. ### 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. ### 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. ```text > /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. ### 01. Palitan ang pangalan ng isang shared type sa iba't ibang package ```text 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. ### 02. Ihiwalay ang code sa dokumentasyon ```text 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. ### 01. I-index ang isang repo sa maguyva.ai Pumili ng isang alam mo na, para masuri mo ang mga sagot. ### 02. Idagdag ang Maguyva sa ilalim ng mcp sa opencode.json `opencode.json` ```json { "mcp": { "maguyva": { "type": "remote", "url": "https://maguyva.tools/mcp", "enabled": true, "headers": { "Authorization": "Bearer {env:MAGUYVA_API_KEY}" } } } } ``` ### 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. Ang [MCP docs](https://opencode.ai/docs/mcp-servers/) ng OpenCode ay tumatalakay sa timeouts, OAuth, at tool access kada agent. ## I-index ang isang repo na kilala mo na. I-connect ang OpenCode sa pamamagitan ng MCP, pagkatapos ay magtanong ng isang bagay na kaya mong tsekin.