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

Canonical source: https://maguyva.ai/fil/for-zed

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).

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.

> 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.

### 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.

### Remote, gamit ang URL

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

### 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 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.

```text
# .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.

### 01. Hanapin ang implementation bago magbukas ng tab ang agent

```text
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.

### 02. Tingnan ang mga dependent bago magbago ng signature

```text
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.

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

`~/.config/zed/settings.json`

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

### 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.

Ang sariling [MCP docs](https://zed.dev/docs/ai/mcp) ng Zed ay tumatalakay sa context servers, agent profiles, at tool permissions.

## I-index ang isang repo na kilala mo na.

I-connect ang Zed sa pamamagitan ng MCP, pagkatapos ay magtanong ng isang bagay na kaya mong tsekin.
