Para sa mga user ng Zed

Mabilis ang Zed. Pero kailangan pa ring hanapin ng agent ang code.

Gumagana ang Zed agent mula sa mga file na binubuksan mo at sa mga instruction na ibinibigay mo. Ini-index ng Maguyva ang buong repo at ibinabalik ito sa pamamagitan ng MCP, kaya nagtatanong ang agent kung nasaan ang isang symbol sa halip na manghula.

Magsimula nang libre Basahin ang setup sa Zed

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

Isang context_servers entry: isang URL at isang Authorization header.

Ang kailangang malaman tungkol sa Zed

Apat na fact na partikular sa Zed. Wala sa mga ito ang mahirap.

// config file nito

settings.json

Nasa ilalim ng context_servers ang mga remote server. Buksan ang file gamit ang zed: open settings file, o magdagdag ng server mula sa Settings → AI → MCP Servers.

// paraan ng koneksyon

Remote, gamit ang URL

Kumokonekta ang Zed sa remote endpoint ng Maguyva sa pamamagitan ng HTTP. Walang local na proseso, walang Node.js.

// ang key

Literal na header

Inilalagay ng guide na ito ang key nang direkta sa Authorization header, dahil hindi pa na-verify dito ang environment-variable expansion sa mga header ng Zed. Itago ito sa user settings mo, hindi sa file na kino-commit mo.

// mga approval

Mga permission ng tool

By default, nagtatanong ang Zed bago ang bawat tool call. Payagan ang mga tool ng Maguyva isa-isa sa ilalim ng agent.tool_permissions.tools, gamit ang mga key gaya ng mcp:maguyva:find_symbol.

Working agreement ang project instructions. Gamitin ang mga ito.

# .rules
- Patakbuhin ang test command ng repo bago mo sabihing tapos na ang isang pagbabago.
- Panatilihin ang mga edit sa loob ng package na ipinabago sa iyo.

Isang project instruction file lang ang nilo-load ng Zed: ang unang tugma mula sa isang nakapirming listahan na nagsisimula sa .rules at kasama ang AGENTS.md at CLAUDE.md. Ang personal na instructions ay nasa ~/.config/zed/AGENTS.md. Gamitin ito para sa:

Mga build, test, at lint command.
Mga convention na paulit-ulit na mali ang agent.
Mga directory na hindi dapat galawin ng agent.

Sinasabi ng instruction file sa agent kung paano magtrabaho. Hindi nito masasabi kung alin sa apat na libong file ang tumatawag sa function na babaguhin nito.

Kapag kulang na ang nakabukas na buffer

Tatlong bagay na hindi matututunan ng Zed agent mula sa mga file sa harap nito.

// hindi ang buong repo ang nakabukas na file

Nakikita ng agent ang binuksan mo at ang na-grep nito. Mukhang magkapareho ang isang helper na may parehong pangalan sa ibang package hanggang ma-ship ang mali.

// wala sa screen ang mga caller

“Ano ang masisira kung babaguhin ko ang signature na ito?” ay isang graph na tanong. Kung walang index, isa-isang binabasa ng agent ang mga file hanggang maubos ang turns o context nito.

// may budget ang context

Bawat file na binubuksan ng agent para makapag-orient ay gumagastos ng tokens na hindi na nito magagamit sa pagbabago. Mas mura ang isang naka-rank na sagot na may file:line kaysa sampung exploratory read.

Maguyva bilang Zed context server

Ang isang context_servers entry ay nagbibigay sa Zed agent 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 tamang file agad ang binubuksan ng agent.
Listahan ng tool na laging updated Nire-reload ng Zed ang mga tool ng isang server kapag nag-anunsyo ng pagbabago ang server, nang walang restart.

Binibigyan ng Zed ang agent ng mabilis na editor.
Binibigyan ng Maguyva ang agent ng mapa ng code.

Dalawang workflow

Tanungin muna ang mapa, saka mag-edit.

// workflow 01

Hanapin ang implementation bago magbukas ng tab ang agent

zed agent> nasaan ang retry policy para sa mga outbound webhook?

find_symbol("retryPolicy")
  src/webhooks/dispatch.ts:41   retryPolicy()   ← implementation
  src/webhooks/__mocks__/dispatch.ts:9   ← mock

→ Binubuksan ng agent ang dispatch.ts:41, hindi ang mock.
[exit 0]

Isang naka-rank na lookup ang pumapalit sa isang round ng grep. Bumabalik ang sagot bilang path at line na direktang mabubuksan ng agent.

// workflow 02

Tingnan ang mga dependent bago magbago ng signature

zed agent> magdagdag ng timeout argument sa fetchInvoice

dependency_search("fetchInvoice", dependents)
  7 caller sa 4 na package

→ Ina-update ng agent ang lahat ng pitong call site sa isang pasada.
[exit 0]

Dumarating ang saklaw ng epekto bago ang unang edit, hindi pagkatapos pumalya ang build.

Setup sa Zed

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 context_servers sa settings ng Zed mo

~/.config/zed/settings.json

{
  "context_servers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

// step 03

Palitan ang placeholder at magtanong ng isa

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