Baru gabung di tim baru terus disodorin codebase rupa monster berisi 200 ribu baris tanpa dokumentasi yang jelas itu rasanya bikin pusing kepala. Dibanding buang waktu seharian baca kode satu-satu sambil nebak-nebak, tool open-source bernama Understand Anything Egonex AI ini punya pendekatan yang beda. Tool ini bakal ngebongkar seluruh struktur proyek, menganalisis dependency, lalu menyulapnya jadi knowledge graph interaktif yang bisa langsung dijelajahi lewat browser.
Gak ada lagi cerita meraba-raba struktur folder di terminal secara buta. Semuanya divisualisasikan secara transparan agar arah dependency antar-file terlihat jelas.
Cara Kerja Hybrid: Tree-sitter Ketemu LLM
Tool ini gak cuma mengandalkan kecerdasan buatan secara mentah. Ada pembagian kerja yang adil antara parser deterministik dan model bahasa (LLM) lewat arsitektur yang cukup rapi.
Untuk urusan memetakan struktur kode secara akurat, mereka memakai Tree-sitter. Parser ini melacak file, fungsi, kelas, import, export, dan dependency secara presisi tanpa bantuan AI. Hasil analisis statis ini menghasilkan data mentah yang konsisten. Output yang sama akan selalu dihasilkan dari kode yang sama.
Setelah struktur dasarnya terbentuk, barulah multi-agent pipeline bertenaga LLM masuk untuk memberikan konteks semantik. Ada enam agent khusus yang bekerja di balik layar:
- project-scanner: Menemukan file serta mendeteksi bahasa pemrograman dan framework yang dipakai.
- file-analyzer: Mengekstrak fungsi, kelas, import, serta membuat node dan edge pada graph.
- architecture-analyzer: Mengelompokkan kode ke dalam lapisan arsitektur (API, Service, Data, UI, Utility).
- tour-builder: Membuat urutan panduan belajar arsitektur berdasarkan tingkat dependency.
- graph-reviewer: Melakukan validasi kelengkapan data graph agar tidak ada relasi yang terputus.
- domain-analyzer: Memetakan kode teknis ke dalam alur bisnis yang nyata.
Kolaborasi ini menghasilkan file .ua/knowledge-graph.json yang menyimpan seluruh peta aplikasi secara akurat.
Fitur yang Bikin Hidup Developer Lebih Tenang
Selain menampilkan node-node yang saling terhubung di browser, fungsionalitas di dalamnya dirancang untuk mempermudah navigasi sehari-hari.
Guided Tours
Alih-alih bingung mau mulai membaca kode dari mana, fitur ini otomatis membuat rute belajar yang runtut. Rute ini diurutkan berdasarkan dependency terdalam, jadi proses belajar tidak melompat-lompat tanpa arah.
Diff Impact Analysis
Ingin mengubah fungsi di dalam file core tapi takut efeknya merembet ke mana-mana? Command /understand-diff membantu memetakan dampak perubahan sebelum commit dilakukan, meminimalkan potensi merusak bagian sistem yang lain.
Fuzzy & Semantic Search
Pencarian tidak terbatas pada kecocokan nama file atau variabel saja. Cukup ketik pertanyaan seperti "bagian mana yang menangani pembayaran?" dan sistem akan mencari node yang relevan secara fungsional berdasarkan makna kontekstualnya.
Layer Visualization & Domain View
Setiap komponen akan diwarnai secara otomatis sesuai layer arsitekturnya. Jika ingin melihat dari sudut pandang non-teknis, tinggal ganti ke tampilan domain untuk melihat bagaimana kode tersebut bekerja dalam alur proses bisnis yang sesungguhnya.
Cara Setup dan Kompatibilitas Platform
Proses instalasi tool ini fleksibel karena mendukung banyak platform koding populer, mulai dari Claude Code hingga IDE modern seperti Cursor.
Untuk pengguna Claude Code, instalasi bisa langsung dilakukan lewat marketplace:
bash/plugin marketplace add Egonex-AI/Understand-Anything /plugin install understand-anything
Jika menggunakan platform lain seperti Codex, Cline, Trae, atau Gemini CLI, instalasi satu baris perintah berikut bisa digunakan di macOS atau Linux:
bashcurl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash
Untuk pengguna Windows, perintah ini bisa dijalankan via PowerShell:
bashiwr -useb https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.ps1 | iex
Setelah terpasang, cukup jalankan command /understand untuk memulai pemindaian codebase. Proses pemindaian pertama memang akan memakan token LLM yang cukup banyak karena menganalisis seluruh file secara mendalam. Namun, pemindaian berikutnya bersifat inkremental, hanya memproses file yang mengalami perubahan sejak eksekusi terakhir.
Berikut adalah tabel kompatibilitas platform yang didukung saat ini:
| Platform | Status | Metode Instalasi |
|---|---|---|
| Claude Code | Native | Plugin marketplace |
| Cursor | Didukung | Auto-discovery |
| VS Code + GitHub Copilot | Didukung | Auto-discovery |
| Copilot CLI | Didukung | Plugin install |
| Codex | Didukung | install.sh codex |
| Gemini CLI | Didukung | install.sh gemini |
| Cline | Didukung | install.sh cline |
| Trae | Didukung | install.sh trae |
| Kiro CLI / IDE | Didukung | install.sh kiro |
Kolaborasi Tim Tanpa Ketergantungan API Key
Satu hal menarik dari proyek ini adalah kemudahan distribusinya. Karena hasil akhirnya berupa file JSON, seluruh folder .ua/ (kecuali folder intermediate/ dan file diff-overlay.json) bisa langsung dimasukkan ke dalam Git.
Setelah di-commit ke repository, rekan satu tim tidak perlu lagi menjalankan pipeline pemindaian ulang yang memakan token AI. Mereka bisa langsung membuka visualisasi dashboard secara lokal tanpa membutuhkan Claude Code, koneksi internet, ataupun API Key. Syaratnya hanya membutuhkan Node.js (versi 18 ke atas) yang terpasang di komputer mereka:
bashnpx https://github.com/Egonex-AI/Understand-Anything/releases/latest/download/understand-anything-viewer.tgz /path/to/analyzed/project
Perintah ini akan membuka local server yang aman dan menyajikan dashboard interaktif secara read-only langsung di browser. Cara ini sangat menghemat waktu proses onboarding developer baru atau saat melakukan review pull request yang kompleks.
Referensi
https://github.com/Egonex-AI/Understand-Anything