Para sa mga user ng Cline

Nagpaplano muna ang Cline bago kumilos. Bigyan ng mapa ang plano.

Nagbabasa ng file ang Cline, nagpapatakbo ng command, at nagtatanong bago magbago ng kahit ano. Ini-index ng Maguyva ang buong repo at ibinabalik ito sa pamamagitan ng MCP, kaya nagsisimula ang Plan mode sa totoong call site sa halip na sa directory listing.

Magsimula nang libre Basahin ang setup sa Cline

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

Gamitin ang .clinerules para sa paraan ng pagtatrabaho. Gamitin ang Maguyva para sa sinasabi ng code ngayon.

Ang kailangang malaman tungkol sa Cline

Apat na fact na partikular sa Cline.

// config file nito

cline_mcp_settings.json

Buksan ito mula sa MCP Servers icon sa Cline panel: Configure tab, pagkatapos ay Configure MCP Servers. Nasa ilalim ng mcpServers ang mga server.

// paraan ng koneksyon

Remote, gamit ang URL

Kumokonekta ang Cline sa endpoint ng Maguyva gamit ang Streamable HTTP. Walang lokal na proseso, walang Node.js.

// ang key

Literal na header

Direktang inilalagay ang key sa Authorization header, gaya ng sa sariling mga halimbawa ng Cline. Nasa user storage ng editor mo ang settings file, hindi sa repo mo.

// type

streamableHttp, hindi SSE

Panatilihin ang "type": "streamableHttp" sa entry: kapag walang type, ipinagpapalagay ng Cline ang lumang SSE. Ilista sa autoApprove ang mga tool na pinagkakatiwalaan mo para laktawan ang approval prompt nila.

Working agreement ang Cline rules. Gamitin ang mga ito.

# .clinerules/testing.md
- Patakbuhin ang test suite bago mo markahang tapos ang task.
- Magtanong muna bago magdagdag ng dependency.

Ang workspace rules ay mga Markdown file sa .clinerules/ o .cline/rules/; binabasa rin ng Cline ang AGENTS.md, .cursorrules, at .windsurfrules. Ang rules ang tamang lugar para sa:

Mga command na dapat patakbuhin ng Cline.
Mga guardrail na naka-scope sa isang path gamit ang frontmatter glob.
Mga team convention na pagod ka nang ulitin.

Sinasabi ng rules sa Cline kung paano kumilos. Hindi nito sinasabi kung aling mga service ang nagbabasa ng table na ililipat nito.

Kapag kulang na ang rules at pagbabasa ng file

Tatlong puwang na pinupunan ng Cline sa pagbabasa ng mas maraming file, isang request bawat beses.

// planong binuo mula sa listing

Nangangatwiran ang Plan mode mula sa nabasa na ng Cline. Sa malaking repo, iyon ay isang directory tree at ilang file, at namamana ng plano ang mga puwang na iyon.

// bawat read ay isang round trip

Bawat file na binubuksan ng Cline para makapag-orient ay gumagastos ng tokens at isang model request. Ang pag-o-orient sa hindi pamilyar na package ay puwedeng umubos ng malaking bahagi ng context window bago ang unang edit.

// string ang nahahanap ng text search, hindi caller

“Sino pa ang tumatawag dito?” ay isang graph na tanong. Nahahanap ng text search ang string; hindi nito naihihiwalay ang totoong mga caller sa isang comment, isang mock, at isang method na may parehong pangalan.

Maguyva bilang MCP server sa Cline

Ang isang mcpServers entry ay nagbibigay sa Cline 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, kaya totoong file ang binabanggit ng plano.
Mga tool na nagbabasa lang Kinu-query ng mga tool ng Maguyva ang index. Wala sa mga ito ang nag-e-edit ng mga file mo.

Sinasabi ng Cline rules sa Cline kung paano magtrabaho.
Binibigyan ng Maguyva ang Cline ng mapang pagbabatayan ng plano.

Dalawang workflow

Magplano batay sa mapa, saka kumilos.

// workflow 01

Planuhin ang pagbabago mula sa totoong call site

cline plan> ilipat ang session refresh sa auth package

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ Inililista ng plano ang tatlong call site bago magsimula ang Act mode.
[exit 0]

Pinapangalanan ng plano ang bawat file na gagalawin nito, kaya listahan ang ina-approve mo, hindi kutob.

// workflow 02

Hanapin ang totoong implementation, hindi ang test fixture

cline> paano natin kinakalkula ang proration?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← implementation
  test/billing/proration.spec.ts:7   ← fixture

→ Isang file ang binabasa ng Cline, hindi anim.
[exit 0]

Inilalagay ng naka-rank na resulta ang implementation sa itaas ng fixture na kapareho nito ng pangalan.

Setup sa Cline

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 MCP settings ng Cline

cline_mcp_settings.json

{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

// step 03

Palitan ang placeholder at magtanong ng isa

Palitan ang mgv_xxxx ng API key mo at i-save ang file. Magtanong ng isang bagay na alam mo na ang sagot, pagkatapos ay buksan ang binanggit na file.