README_id.md

 ▄▀▀▀ █▀▀▄ ▄▀▀▄ █▀▀█ █▀▀▀ █▀▀▄ ▄▀▀▄ ▄▀▀▄ ▀█▀
 █ ▀▄ █▄▄▀ █▄▄█ █▄▄█ █▀▀  █▄▄▀ █  █ █  █  █
 ▀▀▀▀ ▀ ▀▀ ▀  ▀ █    ▀▀▀▀ ▀ ▀▀ ▀▀▀▀ ▀▀▀▀  ▀

Apa itu GrapeRoot?

GrapeRoot adalah mesin konteks sumber terbuka yang berada di antara Anda dan asisten pengkodean AI Anda. GrapeRoot membangun graf semantik dari basis kode Anda — file, simbol, impor, rantai pemanggilan — lalu memuat tepat kode yang relevan ke setiap prompt sebelum AI Anda menerimanya.

Hasilnya: AI Anda menggunakan token untuk berpikir, bukan menjelajahi.

Anda menjalankan: dgc /path/to/project
              ↓
1. Proyek dipindai → graf semantik dibangun (file, simbol, impor)
2. Anda mengajukan pertanyaan
3. Graf mengidentifikasi file yang relevan → memuatnya ke dalam konteks
4. AI menerima pertanyaan Anda + kode yang tepat sudah siap
5. Lebih sedikit giliran, lebih sedikit token, jawaban lebih baik

Penghematan token berlipat ganda sepanjang sesi. Graf mengingat file mana yang telah dibaca, diedit, dan dikueri — setiap giliran semakin hemat.

Hasil

Diuji pada beberapa basis kode nyata (lebih dari 7.700 file) dan lebih dari 50 prompt rekayasa:

Pengurangan biaya berdasarkan jenis tugas

Penghematan berlipat ganda sepanjang sesi — token yang dihindari pada giliran 3 juga menghindari penagihan ulang cache di setiap giliran berikutnya. Kualitas tetap setara atau meningkat pada setiap jenis tugas di atas.

Metodologi dan hasil benchmark lengkap: graperoot.dev/benchmarks

Alat AI yang Didukung

Bahasa Pemrograman yang Didukung

TypeScript · JavaScript · Python · Go · Swift · Rust · Java · Kotlin · Scala · C# · Ruby · PHP

Instalasi

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.sh | bash
source ~/.zshrc   # atau ~/.bashrc / ~/.profile

Windows (PowerShell):

irm https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.ps1 | iex

Windows (Scoop):

scoop bucket add dual-graph https://github.com/kunal12203/scoop-dual-graph
scoop install dual-graph

Prasyarat: Python 3.10+, Node.js 18+, dan salah satu alat AI yang didukung. Penginstal mendeteksi alat yang belum terpasang dan menawarkan untuk menginstalnya secara otomatis.

Penggunaan

Penting: Selalu gunakan dgc (bukan claude secara langsung) untuk memastikan server MCP berjalan.

Claude Code

dgc                                      # pindai direktori saat ini, jalankan Claude
dgc /path/to/project                     # pindai proyek tertentu
dgc /path/to/project "fix the login bug" # mulai dengan prompt

OpenAI Codex CLI

dg                              # pindai direktori saat ini
dg /path/to/project             # pindai proyek tertentu
dg /path/to/project "add tests" # mulai dengan prompt

Pemilih Interaktif (baru di v3.9.99)

graperoot          # tampilkan konfirmasi direktori + pemilih alat dengan tombol panah
graperoot .        # sama, mulai dari direktori saat ini
graperoot --version   # tampilkan versi saat ini
graperoot --update    # paksa pembaruan sendiri

Semua Alat via graperoot

graperoot . --cursor          # Cursor
graperoot . --gemini          # Gemini CLI
graperoot . --opencode        # OpenCode
graperoot . --copilot         # GitHub Copilot
graperoot . --openclaw        # OpenClaw
graperoot . --kilocode        # Kilocode
graperoot . --mimocode        # MiMo Code
graperoot /path --gemini "add tests"   # proyek tertentu + prompt

Windows

dgc .                          # dari dalam direktori proyek
dgc "D:\projects\my-app"       # drive apa pun, path apa pun
dg "C:\work\backend"           # Codex CLI
dgc --gemini "D:\projects\app" # Gemini CLI di Windows

Cara Kerjanya

1. Pemindaian graf — pada jalankan pertama, GrapeRoot mengekstrak file, fungsi, kelas, dan hubungan impor ke dalam graf lokal yang tersimpan di .dual-graph/.
2. Pengambilan konteks — setiap kali Anda mengajukan pertanyaan, graf menentukan peringkat file yang paling relevan dan memuatnya ke dalam prompt sebelum AI Anda menerimanya.
3. Memori sesi — file yang telah Anda baca, edit, atau kueri diberi bobot lebih tinggi pada giliran berikutnya. Konteks berlipat ganda.
4. Alat MCP — AI Anda tetap dapat menggali lebih dalam melalui alat berbasis graf (graph_read, graph_retrieve, graph_neighbors) bila perlu melakukan eksplorasi lebih lanjut.

Semua pemrosesan dilakukan secara lokal. Tidak ada kode yang meninggalkan mesin Anda.

Data & File

Semua data tersimpan di <project>/.dual-graph/ (ditambahkan otomatis ke .gitignore):

Instalasi global di ~/.dual-graph/:

Konfigurasi

Semua bersifat opsional, melalui variabel lingkungan:

Pembaruan Otomatis

Peluncur memeriksa pembaruan setiap kali dijalankan dan memperbarui dirinya sendiri secara diam-diam. Untuk memaksa pembaruan:

graperoot --update

Untuk menonaktifkan pembaruan otomatis:

graperoot --no-auto-update

Untuk mengaktifkannya kembali:

graperoot --auto-update

Versi saat ini: 3.10.16

Telemetri

GrapeRoot mengumpulkan laporan kerusakan anonim untuk membantu memperbaiki bug. Yang dikirim: jenis error, langkah mana yang gagal, versi OS/Python, versi GrapeRoot. Tidak pernah dikirim: kode Anda, jalur file, nama proyek, atau data pribadi.

graperoot --no-telemetry    # disable
graperoot --telemetry       # re-enable

GrapeRoot Pro

GrapeRoot Pro menambahkan fitur canggih untuk pengguna tingkat lanjut:

• Mode tugas menyeluruh — analisis multi-file mendalam untuk refaktor yang kompleks
• Deteksi ekspor tak terpakai — temukan ekspor yang tidak digunakan di seluruh basis kode
• Pencari siklus dependensi — deteksi rantai impor melingkar
• Pencarian lintas basis kode — pencarian semantik di beberapa repositori sekaligus
• Pelindung undo — kait sebelum penggunaan alat yang melindungi operasi destruktif

Pemecahan Masalah

"MCP Server Connection Failed"

Selalu gunakan dgc alih-alih claude secara langsung. dgc memulai server MCP secara otomatis.

# Perbaikan:
claude mcp remove dual-graph
dgc   # mendaftarkan ulang semuanya

Panduan pemecahan masalah lengkap

Lihat TROUBLESHOOTING.md atau graperoot.dev/docs.

Berkontribusi

Skrip peluncur (bin/) bersumber terbuka di bawah lisensi Apache 2.0. PR sangat disambut — perbaikan bug, dukungan asisten AI baru, peningkatan instalasi, dokumentasi.

Catatan: Mesin graf (graperoot paket pip) bersifat proprietari. Peluncur dan perkakas di repositori ini sepenuhnya bersumber terbuka.

Komunitas

Ada pertanyaan, menemukan bug, atau ingin berbagi masukan?

Bergabung di Discord →

Riwayat Bintang

Lisensi

Skrip peluncur dan perkakas dalam repositori ini: Apache License 2.0

Mesin graf graperoot (PyPI): proprietari. Lihat graperoot.dev/graperoot-pro.