Untuk pengguna OpenCode

AGENTS.md memberitahu OpenCode peraturan anda.
Maguyva menunjukkan kod kepadanya.

OpenCode membaca AGENTS.md untuk cara bekerja dan memanggil pelayan MCP untuk selebihnya. Maguyva ialah pelayan MCP jauh yang memberi OpenCode peta repo anda yang boleh disoal, dengan laluan fail dan nombor baris.

Mula percuma Baca persediaan OpenCode

Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

Satu entri jauh di bawah mcp. Tiada apa yang berjalan secara tempatan.

Apa yang perlu diketahui tentang OpenCode

Empat fakta khusus untuk OpenCode.

// fail konfigurasi

opencode.json

Tambah pelayan di bawah mcp dalam opencode.json projek anda, atau dalam ~/.config/opencode/opencode.json untuk semua projek.

// pengangkutan

type: remote

OpenCode bersambung ke titik akhir Maguyva melalui HTTP. Tiada apa yang berjalan secara tempatan dan Node.js tidak diperlukan.

// kunci

Rujukan env

OpenCode menggantikan pemboleh ubah persekitaran dalam konfigurasinya, jadi pengepala berbunyi Bearer {env:MAGUYVA_API_KEY} dan kunci tidak masuk ke dalam fail yang anda commit.

// bajet konteks

Hadkan mengikut ejen

Setiap pelayan MCP menambah definisi alat ke dalam konteks. OpenCode boleh mematikan alat sesuatu pelayan secara global dengan glob seperti "maguyva*": false dan menghidupkannya semula untuk ejen yang memerlukannya.

AGENTS.md ialah persetujuan kerja. Gunakannya.

> /init
# mengimbas repo dan menulis AGENTS.md

OpenCode membaca AGENTS.md di akar projek dan ~/.config/opencode/AGENTS.md untuk peraturan peribadi. Tanpa AGENTS.md, ia beralih kepada CLAUDE.md. Gunakannya untuk:

Arahan build, ujian dan lint.
Konvensyen dan sempadan yang perlu dihormati ejen.
Penunjuk kepada dokumen penting.

Imbasan semasa /init ialah ringkasan, bukan indeks. Ia tidak memberitahu OpenCode siapa yang memanggil fungsi yang ditambah semalam.

Apabila AGENTS.md tidak mencukupi

Tiga jurang yang OpenCode isi dengan grep dan kesabaran.

// ringkasan bukan indeks

AGENTS.md boleh menamakan pakej yang penting. Ia tidak boleh menyenaraikan setiap simbol dan tapak panggilan, dan tidak sepatutnya cuba.

// grep menemui rentetan, bukan pemanggil

Padanan teks tidak dapat membezakan panggilan sebenar daripada komen, mock atau kaedah bernama sama dalam kelas lain.

// fail itu ketinggalan

AGENTS.md betul pada hari ia ditulis. Kod terus bergerak; fail itu berubah apabila seseorang teringat untuk mengemas kininya.

Maguyva sebagai pelayan MCP jauh dalam OpenCode

Satu entri di bawah mcp memberi OpenCode:

11 alat merentasi repo anda yang diindeks carian semantik, struktur (AST), graf dan teks, ditambah carian simbol, dependen dan pengambilan fail.
Jawapan dengan laluan fail dan nombor baris merentasi 285+ bahasa.
Jawapan yang sama untuk setiap model OpenCode berfungsi dengan banyak penyedia model. Maguyva memulangkan peta yang sama, tidak kira model mana yang bertanya.

AGENTS.md memberitahu OpenCode cara bekerja.
Maguyva memberi OpenCode sesuatu untuk mula bekerja.

Dua aliran kerja

Tanya peta dari terminal yang sama.

// workflow 01

Namakan semula jenis yang dikongsi merentasi pakej

opencode> namakan semula OrderStatus kepada FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 rujukan merentasi 8 pakej
structural_search(switch_statement, "OrderStatus")
  4 switch menyeluruh

→ OpenCode menyunting seluruh senarai, termasuk switch.
[exit 0]

Switch menyeluruh ialah yang terlepas oleh carian teks dan lambat dikesan oleh pengkompil.

// workflow 02

Bezakan kod daripada dokumentasi

opencode> di mana FEATURE_BULK_EXPORT dibaca?

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

→ Dua laluan kod, satu dokumen lapuk.
[exit 0]

Padanan tepat kembali bersama laluannya, jadi OpenCode boleh membezakan kod daripada dokumentasi sebelum menyunting salah satunya.

Sediakan OpenCode

Tiga langkah. Peringkat Free: 3 repositori, Sehingga 50K baris repo terindeks, tanpa kad.

// step 01

Indeks repo di maguyva.ai

Pilih satu yang anda sudah kenali, supaya anda boleh menilai jawapannya.

// step 02

Tambah Maguyva di bawah mcp dalam opencode.json

opencode.json

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

// step 03

Eksport kunci anda dan semak sambungan

Tetapkan MAGUYVA_API_KEY dalam shell yang memulakan OpenCode. opencode mcp list menunjukkan setiap pelayan yang dikonfigurasi; kemudian tanya satu soalan yang anda sudah tahu jawapannya.