# Maguyva

Panduan singkat untuk alur kerja Maguyva MCP yang umum: memasang klien, mencari sebelum mengedit, menangani hasil kosong, dan bekerja lintas repositori.

[llms-full.txt — English documentation and MCP schemas](/llms-full.txt)

Markdown representation of any docs page or blog post: append `.md` to its URL (https://maguyva.ai/id/docs/quickstart.md) or send `Accept: text/markdown`.

Release feeds: [RSS](https://maguyva.ai/id/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/id/changelog.json).

## Kapabilitas Bahasa

Berikut angka kapabilitas yang menggerakkan structural search, symbol lookup, analisis berbasis graf, dan indexing dasar.

Penanda ini menunjukkan kemampuan yang diaktifkan dalam konfigurasi bahasa saat ini, bukan skor kualitas proses secara menyeluruh. Ketersediaan graf memerlukan parser, ekstraksi simbol, dan ekstraksi graf yang aktif. Jenis relasi yang didukung dan kedalaman ekstraksi berbeda menurut bahasa.

- Cakupan terindeks: **284**. Setiap bahasa yang terdaftar diindeks untuk konteks file, teks, dan repository.
- Pencarian struktural AST: **247**. Bahasa dengan struktur berbasis parser untuk AST dan alur kerja structural search.
- Ekstraksi simbol: **282**. Bahasa dengan metadata simbol untuk definisi dan pencarian.
- Relasi graf: **151**. Bahasa dengan ekstraksi relasi operasional untuk pencarian berbasis graf. Kedalamannya berbeda menurut bahasa dan jenis relasi.

- `ast_structural=false`: Indexing berbasis teks dengan pemahaman struktur yang lebih terbatas.
- `symbol_extraction=false`: Ekstraksi simbolnya terbatas, jadi navigasinya lebih mengandalkan konteks file dan struktur.
- `relationship_extraction=false`: Bahasa ini diindeks untuk pencarian, tetapi saat ini belum dipersistensikan ke dalam graf kode.

[Temukan bahasa Anda](/llms-full.txt)

## Buku Resep

Resep praktis untuk pekerjaan sehari-hari Maguyva MCP. Setiap resep memberi nama alat dan urutannya — bukan referensi parameter lengkap. Untuk parameter alat, gunakan [Referensi MCP API](https://maguyva.ai/id/docs/mcp-api). Untuk pengaturan pertama kali, gunakan [Mulai cepat](https://maguyva.ai/id/docs/quickstart).

### Pilih alat yang tepat

Kebanyakan pertanyaan dimulai dengan satu panggilan. Lanjutkan ke pencarian yang lebih mendalam hanya jika jawaban pertama terlalu luas atau informasinya kurang.

- `intelligent_search` — mulai di sini untuk pertanyaan tentang basis kode dalam bahasa alami. Pengaturan bawaan auto/balanced mengarahkan kueri yang dikenali dengan keyakinan tinggi sebagai pencarian definisi ke pencarian struktural, pertanyaan tentang referensi atau dampak ke graf, dan pertanyaan tentang kecocokan persis ke pencarian teks. Pertanyaan lainnya menggunakan makna semantik dan teks yang diindeks. Gunakan mode=hybrid atau auto dengan quality=thorough untuk meminta keempat modalitas pencarian. Mode yang dipilih secara eksplisit didahulukan daripada quality.
- `find_symbol` — gunakan saat Anda sudah mengetahui nama fungsi, kelas, atau variabel.
- `dependency_search` — petakan dampak: kode pemanggil, kode yang bergantung pada simbol, dan efek sebelum maupun sesudah perubahan.
- `get_task_context` — untuk area yang belum dikenal; satu paket terbatas berisi file, symbol, dan dependensi berdasarkan deskripsi tugas.
- `repository_context` — tampilkan repositori yang dapat diakses atau periksa bagaimana nama repositori di-resolve.
- `ask_maguyva` dengan `operation="guidance"` — bantuan lokal untuk memilih dan menggunakan alat Maguyva, tanpa mengubah repo.

## Tools -- Search

- [intelligent_search](https://maguyva.ai/id/docs/mcp-api#intelligent-search): Start here for any codebase question. Default auto/balanced routes confident definition queries to structural search, reference/impact queries to graph, and exact-match queries to text; other queries use semantic plus text.
- [semantic_search](https://maguyva.ai/id/docs/mcp-api#semantic-search): Find code by meaning, not exact text. Use for conceptual queries like "retry logic" or "user onboarding flow" when you don't know the keyword or symbol name.
- [text_pattern_search](https://maguyva.ai/id/docs/mcp-api#text-pattern-search): Search indexed content. Exact and regex modes grep the full file/blob corpus; fuzzy content mode searches the bounded semantic chunk corpus.

## Tools -- Structural & Graph

- [structural_search](https://maguyva.ai/id/docs/mcp-api#structural-search): Prefer preset=functions|classes|methods|imports|variables (or free pattern=). Find code by AST shape (not text).
- [dependency_search](https://maguyva.ai/id/docs/mcp-api#dependency-search): Primary blast-radius / graph surface. Answer "what calls this?" / "what does this use?" via the real call/import graph.

## Tools -- Code Analysis

- [find_symbol](https://maguyva.ai/id/docs/mcp-api#find-symbol): Jump to where a function, class, or variable is defined and used. Use when you know the name (e.g. "getCurrentUser") — faster and more precise than Grep, and it spans the whole indexed repo.
- [analyze_dependencies](https://maguyva.ai/id/docs/mcp-api#analyze-dependencies): Analyze blast radius using the same traversal as dependency_search (dependents/incoming). Prefer dependency_search with analysis_type="dependents" or "impact" for impact analysis.
- [get_task_context](https://maguyva.ai/id/docs/mcp-api#get-task-context): Starting work in an unfamiliar area? Describe the task (e.g. "add SSO support", "fix the billing webhook") and get a bounded one-call bundle of relevant files, code, symbols, and dependencies.
- [get_file](https://maguyva.ai/id/docs/mcp-api#get-file): Read a file from the indexed repo by path. Prefer local file tools for files on disk; use this for remote indexed snapshots.

## Tools -- Utility

- [repository_context](https://maguyva.ai/id/docs/mcp-api#repository-context): List the repositories you can search, or get identity info on one (namespace/branch, indexed_commit_sha / index freshness). Use action:"list" when the repo slug is unknown; searches accept a known slug directly or default to your key's single repo.
- [ask_maguyva](https://maguyva.ai/id/docs/mcp-api#ask-maguyva): Get Maguyva tool guidance, or submit a bug report / feature request stored for Maguyva's maintainers. Never include secrets or sensitive personal data in feedback.

## Langkah selanjutnya

- [Mulai cepat](https://maguyva.ai/id/docs/quickstart)
- [Panduan Instalasi](https://maguyva.ai/id/docs/installation)
- [Referensi MCP API](https://maguyva.ai/id/docs/mcp-api)
- [Pemecahan masalah](https://maguyva.ai/id/docs/troubleshooting)
- [Cara Kerjanya](https://maguyva.ai/id/docs/how-it-works)
- [Kompatibilitas & Spesifikasi Teknis](https://maguyva.ai/id/docs/compatibility)

## Agent integrations

- [Maguyva untuk Cursor: konteks codebase lewat MCP](https://maguyva.ai/id/for-cursor): Cursor mengedit file yang terbuka; Maguyva mengindeks seluruh monorepo dan menyajikannya kembali lewat MCP — pencarian semantic, AST, graph, dan text dengan file:line, sehingga agen menemukan file yang tidak Anda pin.
- [Maguyva untuk Windsurf: konteks codebase lewat MCP](https://maguyva.ai/id/for-windsurf): Windsurf dan Cascade mengedit file yang terbuka; Maguyva mengindeks seluruh monorepo dan menyajikannya lewat MCP — semantic, AST, graph, dan text dengan file:line, sehingga Cascade menemukan file yang tidak Anda sebutkan.
- [Maguyva untuk Antigravity: konteks codebase lewat MCP](https://maguyva.ai/id/for-antigravity): Antigravity menjalankan agen otonom di editor, terminal, dan browser; Maguyva memberi mereka peta monorepo yang bisa di-query lewat MCP — cakupan dampak diketahui sejak awal, bukan setelah CI merah.
- [Maguyva untuk Codex: konteks codebase lewat MCP](https://maguyva.ai/id/for-codex): AGENTS.md adalah kesepakatan kerja. Maguyva adalah server MCP yang memberi Codex CLI peta repo yang dapat dikueri, sehingga suntingan pertama bukan tebakan.
- [Maguyva untuk client MCP apa pun: konteks codebase lewat MCP](https://maguyva.ai/id/for-anything): MCP adalah protokol terbuka. Maguyva adalah server MCP standar, jadi klien yang mendukung MCP seperti Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity mendapat konteks codebase yang sama, berbasis fakta.
- [Maguyva untuk Gemini CLI: konteks codebase lewat MCP](https://maguyva.ai/id/for-gemini): GEMINI.md menetapkan konteks kerja; MCP adalah salurannya. Maguyva adalah server MCP yang memberi Gemini CLI peta repo Anda yang bisa di-query — pencarian semantic, AST, dan graph sehingga edit pertama bukan tebakan.
- [Maguyva untuk Claude Code: konteks codebase lewat MCP](https://maguyva.ai/id/for-claude-code): CLAUDE.md memberi tahu Claude cara berperilaku. Maguyva mengindeks repo dan menyajikannya lewat MCP agar Claude Code menyunting berdasarkan peta yang dapat dikueri.
- [Maguyva untuk GitHub Copilot CLI: konteks kode lewat MCP](https://maguyva.ai/id/for-copilot): Instruksi khusus memberi tahu Copilot cara berperilaku. Maguyva mengindeks repo dan menyajikannya lewat MCP agar GitHub Copilot CLI menyunting berdasarkan peta.

## Company

- [Tentang Maguyva: Kecerdasan Kode via MCP](https://maguyva.ai/id/about): Kecerdasan kode untuk agen coding: pencarian semantik, AST, graf, dan teks lengkap, symbol lookup, analisis dependensi, dan konteks tugas dalam satu panggilan di 284+ bahasa.
- [Kenalan dengan Tim: 2 Manusia + Kawanan Agent AI](https://maguyva.ai/id/team)
- [Cara Kami Bekerja: Tanpa VC, Tanpa Biaya per Pengguna, Tanpa Fitur Terkunci](https://maguyva.ai/id/how): Tanpa modal luar. Tanpa biaya per pengguna. Datamu bukan produk. Bagaimana Maguyva dibangun dan kenapa harganya seperti itu.
- [Stack Teknologi: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/id/stack): Stack teknis di balik Maguyva. PostgreSQL, embedding Voyage AI, pencarian vektor terkuantisasi, AST tree-sitter, dan protokol MCP.
- [Changelog](https://maguyva.ai/id/changelog): Yang dirilis di Maguyva: perubahan produk, pembaruan indeks dan alat MCP, serta catatan dari proses build. Terbaru lebih dulu.
- [Live: Maguyva Membangun Dirinya Sendiri, Secara Real Time](https://maguyva.ai/id/live): Bukan demo rekayasa. Ini log dispatch yang sesungguhnya — setiap panggilan tool, error, dan commit dari tim agent AI yang membangun Maguyva, secara live.

## Guides

- [Bukan full-text search yang menyamar pakai jas panjang. Lima mode retrieval yang menyatu.](https://maguyva.ai/id/beyond-rag): Kode butuh lebih dari sekadar chunk semantik. Maguyva menyatukan lima mode retrieval menjadi satu jawaban berperingkat, berlandaskan repo nyata lewat MCP di 284 bahasa. Paket Free, tanpa kartu kredit.
- [File instruksi bukan peta kode Anda. Maguyva, iya.](https://maguyva.ai/id/beyond-rules-files): CLAUDE.md dan AGENTS.md memberi tahu agent bagaimana harus bersikap. Mereka tidak memberi tahu apa isi codebase-nya. Maguyva adalah layer konteks codebase lewat MCP di 284 bahasa. Paket Free, tanpa kartu kredit.
- [Mengedit itu mudah. Mengetahui apa yang rusak itu sulit. Maguyva memetakannya.](https://maguyva.ai/id/know-what-breaks): Sebelum refactor, agen Anda harus tahu setiap komponen yang memanggil, mengimpor, atau bergantung pada kode tersebut. Maguyva menjawabnya dari graf panggilan nyata lewat MCP, bukan dari grep. Paket Free, tanpa kartu kredit.
- [Mulai gratis: layer konteks codebase untuk agent coding AI](https://maguyva.ai/id/map-then-change): Petakan dulu. Ubah kemudian. Maguyva memberi agent coding AI Anda peta codebase yang bisa diquery lewat MCP, sebelum edit pertama. 11 tool di 284 bahasa. Paket Free, tanpa kartu kredit.
- [Agent Anda memulai secara buta di repo Anda. Maguyva memberinya peta.](https://maguyva.ai/id/stop-flying-blind): Agent coding memindai file yang salah dan mengedit sebelum memahami kodenya. Maguyva memberi agent Anda peta codebase yang bisa diquery lewat MCP di 284 bahasa. Paket Free, tanpa kartu kredit.