GitNexus Essentials

Panduan lengkap menggunakan GitNexus untuk navigasi kode cerdas, analisis dampak, dan refactoring.

Apa itu GitNexus?

GitNexus adalah tool code intelligence berbasis AI yang membangun knowledge graph dari codebase Anda, memungkinkan navigasi kode lanjutan, analisis dampak, dan refactoring yang aman.

Fitur Utama:

Knowledge graph hubungan kode

Analisis dampak sebelum membuat perubahan

Refactoring aman dengan dependency tracking

Eksplorasi dan navigasi kode

Debugging dan error tracing

Visualisasi arsitektur

Instalasi

Prasyarat

Node.js 18+ terinstal

Git repository sudah diinisialisasi

Install GitNexus

# Install global
npm install -g gitnexus

# Atau gunakan dengan npx (tanpa instalasi)
npx gitnexus <command>

Konsep Dasar

Knowledge Graph

GitNexus membangun graph database berisi:

Nodes: Entitas kode (files, functions, classes, types)

Edges: Relasi (imports, calls, extends, implements)

Clusters: Pengelompokan logis kode terkait

Flows: Aliran eksekusi dan data

Struktur Index

.gitnexus/
├── index.db        # Database knowledge graph
├── cache/          # Cache analisis
└── config.json     # Konfigurasi

Perintah Dasar

Inisialisasi dan Analisis

# Analisis repository saat ini
npx gitnexus analyze

# Analisis direktori spesifik
npx gitnexus analyze ./src

# Paksa analisis ulang (abaikan cache)
npx gitnexus analyze --force

Output:

✓ Repository indexed successfully (5.4s)
  1,343 nodes | 1,666 edges | 12 clusters | 38 flows

Cek Status

# Lihat status index
npx gitnexus status

# Output menampilkan:
# - Commit terakhir yang diindex
# - Jumlah nodes/edges
# - Kesegaran index

Bersihkan Index

# Hapus index dan mulai fresh
npx gitnexus clean

# Hapus cache saja
npx gitnexus clean --cache-only

Eksplorasi Kode

Mencari Kode

# Cari symbol
npx gitnexus query "ContactForm"

# Temukan semua penggunaan
npx gitnexus usages ContactForm

# Temukan definisi
npx gitnexus definition ContactForm

Navigasi Relasi

# Apa yang diimport file ini?
npx gitnexus imports components/contact/ContactForm.tsx

# Apa yang mengimport file ini?
npx gitnexus imported-by components/contact/ContactForm.tsx

# Tampilkan semua dependencies
npx gitnexus dependencies components/contact/

Analisis Dampak

Sebelum Membuat Perubahan

# Cek apa yang bergantung pada file ini
npx gitnexus impact components/ui/Button.tsx

# Output menampilkan:
# - Direct dependents
# - Indirect dependents
# - File test yang terpengaruh
# - Penilaian risiko

Contoh Output

Impact Analysis: components/ui/Button.tsx
────────────────────────────────────────
Direct dependents (12):
  • app/[lang]/contact/page.tsx
  • components/contact/ContactForm.tsx
  • components/content/Hero.tsx
  ...

Indirect dependents (45):
  • app/[lang]/about/page.tsx
  • app/[lang]/resume/page.tsx
  ...

Risk: MEDIUM
Recommendation: Run tests in affected modules

Refactoring

Rename Symbol

# Rename function di seluruh codebase
npx gitnexus rename oldFunction newFunction

# Rename component
npx gitnexus rename ContactForm ContactFormV2

Pindahkan File

# Pindahkan file dan update semua import
npx gitnexus move src/old/path.ts src/new/path.ts

# Pindahkan direktori
npx gitnexus move components/old/ components/new/

Extract Component

# Extract kode ke component baru
npx gitnexus extract components/Form.tsx "FormField" --to components/FormField.tsx

Debugging

Trace Error

# Trace dari mana error berasal
npx gitnexus trace "Cannot read property 'name'"

# Cari error handler
npx gitnexus query "try.*catch"

Temukan Call Chain

# Bagaimana data mengalir dari A ke B?
npx gitnexus flow-from validateForm --to submitForm

# Tampilkan semua path
npx gitnexus paths ContactForm.handleSubmit --to fetch

Visualisasi Arsitektur

Generate Diagram

# Visualisasi struktur modul
npx gitnexus visualize --output architecture.svg

# Dependency graph component
npx gitnexus graph components/ --output components.png

Export Dokumentasi

# Generate wiki arsitektur
npx gitnexus wiki --output docs/architecture/

# Export ke Markdown
npx gitnexus export --format markdown --output ARCHITECTURE.md

Integrasi dengan Claude Code

GitNexus terintegrasi mulus dengan Claude Code melalui MCP (Model Context Protocol).

Tool MCP yang Tersedia

Saat menggunakan Claude Code, Anda bisa meminta Claude untuk:

"Apa yang akan rusak jika saya ubah function ini?"
→ Menggunakan gitnexus__impact

"Tunjukkan bagaimana component ini digunakan"
→ Menggunakan gitnexus__query

"Bantu saya refactor ini dengan aman"
→ Menggunakan gitnexus__shape_check

Skill Claude

GitNexus menyediakan beberapa skill di Claude Code:

gitnexus-exploring: Memahami cara kerja kode gitnexus-debugging: Trace bug dan error gitnexus-refactoring: Refactoring kode yang aman gitnexus-impact-analysis: Menilai dampak perubahan gitnexus-cli: Perintah analisis repository

Konfigurasi

.gitnexus/config.json

{
  "include": [
    "src/**/*.ts",
    "src/**/*.tsx",
    "components/**/*.tsx"
  ],
  "exclude": [
    "**/*.test.ts",
    "**/*.spec.ts",
    "**/node_modules/**"
  ],
  "analysis": {
    "depth": "deep",
    "includeTests": false,
    "trackTypes": true
  }
}

Konfigurasi Umum

Abaikan File Test:

{
  "exclude": ["**/*.test.*", "**/*.spec.*"]
}

Fokus pada Direktori Tertentu:

{
  "include": ["src/**", "components/**"]
}

Best Practice

Jaga Index Tetap Fresh

# Jalankan setelah pull perubahan
git pull && npx gitnexus analyze

# Setup git hook
echo "npx gitnexus analyze" > .git/hooks/post-merge
chmod +x .git/hooks/post-merge

Sebelum Refactoring Besar

Analisis dampak: Cek apa yang bergantung pada kode

Review flow: Pahami execution path

Cek test: Pastikan test coverage

Refactor: Gunakan tool rename/move GitNexus

Re-analisis: Update index

Tips Performa

Exclude file generated yang besar

Gunakan --incremental untuk analisis lebih cepat

Clear cache jika index sudah stale

Analisis saat idle time untuk repo besar

Workflow Umum

Menambah Component Baru

# 1. Cek component serupa
npx gitnexus query "ContactForm"

# 2. Temukan pattern yang diikuti
npx gitnexus imports components/contact/ContactForm.tsx

# 3. Buat component
# (buat file Anda)

# 4. Update index
npx gitnexus analyze

Debug Issue Production

# 1. Temukan error di kode
npx gitnexus query "error message"

# 2. Trace call chain
npx gitnexus flow-from entry --to errorFunction

# 3. Temukan semua error handler
npx gitnexus query "catch.*Error"

# 4. Cek perubahan terkini
git log --oneline -- affected/file.ts

Refactoring Aman

# 1. Cek dampak
npx gitnexus impact components/ui/Button.tsx

# 2. Review dependent
npx gitnexus imported-by components/ui/Button.tsx

# 3. Rename/move pakai GitNexus
npx gitnexus rename Button PrimaryButton

# 4. Verifikasi tidak ada import yang rusak
npm run build

Troubleshooting

Index Kadaluarsa

Masalah: GitNexus menampilkan hasil lama

Solusi:

npx gitnexus clean
npx gitnexus analyze --force

Analisis Terlalu Lambat

Masalah: Analisis memakan waktu lama

Solusi:

# Exclude direktori besar
# Update .gitnexus/config.json
{
  "exclude": ["**/dist/**", "**/build/**", "**/.next/**"]
}

Dependency Hilang

Masalah: Beberapa relasi tidak ditemukan

Solusi:

# Tingkatkan kedalaman analisis
npx gitnexus analyze --depth deep

# Include file test
npx gitnexus analyze --include-tests

Penggunaan Lanjutan

Query Custom

# Temukan semua async function
npx gitnexus query "async function"

# Temukan React hooks
npx gitnexus query "use[A-Z].*"

# Temukan komentar TODO
npx gitnexus query "TODO:"

Export untuk CI/CD

# Generate laporan dampak
npx gitnexus impact --json > impact-report.json

# Cek apakah perubahan mempengaruhi critical path
npx gitnexus check-critical --files changed-files.txt

Integrasi dengan Tool Lain

# Export ke Neo4j
npx gitnexus export --format neo4j --output graph.cypher

# Generate TypeScript definition
npx gitnexus types --output types/graph.d.ts

Sumber Daya

Dokumentasi Resmi: https://gitnexus.dev/docs

GitHub: https://github.com/gitnexus/gitnexus

Contoh: https://gitnexus.dev/examples

Komunitas: https://discord.gg/gitnexus

Kartu Referensi Cepat

# Analisis
npx gitnexus analyze                 # Index codebase
npx gitnexus status                  # Cek status
npx gitnexus clean                   # Hapus index

# Eksplorasi
npx gitnexus query "symbol"          # Cari kode
npx gitnexus usages Symbol           # Cari penggunaan
npx gitnexus definition Symbol       # Cari definisi

# Analisis Dampak
npx gitnexus impact file.ts          # Cek dampak
npx gitnexus dependencies path/      # Tampilkan deps

# Refactoring
npx gitnexus rename old new          # Rename symbol
npx gitnexus move old.ts new.ts      # Pindah file

# Debugging
npx gitnexus trace "error"           # Trace error
npx gitnexus flow-from A --to B      # Tampilkan flow

# Visualisasi
npx gitnexus visualize               # Generate diagram
npx gitnexus wiki                    # Buat wiki

Langkah Selanjutnya

Jalankan npx gitnexus analyze di project Anda

Coba eksplorasi kode dengan npx gitnexus query

Cek dampak sebelum membuat perubahan

Gunakan skill GitNexus di Claude Code

---

Terakhir Diupdate: 2026-04-20 Versi GitNexus: 1.x Tingkat Kesulitan: Menengah