gkg

Semantic code analysis engine using AST parsing and KuzuDB graph database. Enables IDE-like code navigation for AI assistants.

Status: Public beta | Requires: Git repository | Storage: ~/.gkg/

When to Use

• Find all usages of a function/class across codebase
• Go-to-definition for symbols
• Impact analysis before refactoring
• Generate architecture diagrams
• RAG-enhanced code understanding

Use repomix instead for: quick context dumps, any-language support, remote repos, token counting.

Quick Start

# Check installation
gkg --version

# Index current repo
gkg index

# Start server (for API/MCP)
gkg server start

# Stop before re-indexing
gkg server stop

Installation

# macOS/Linux
curl -fsSL https://gitlab.com/gitlab-org/rust/knowledge-graph/-/raw/main/install.sh | bash

# Windows (PowerShell)
irm https://gitlab.com/gitlab-org/rust/knowledge-graph/-/raw/main/install.ps1 | iex

Core Workflows

Index and Query

gkg index /path/to/project --stats
gkg server start
# Query via HTTP API at http://localhost:27495

Find Symbol Usages

1. Index project: gkg index
2. Start server: gkg server start
3. Use MCP tool get_references or HTTP API /api/graph/search

Impact Analysis

1. Index affected repos
2. Query get_references for changed symbols
3. Review all call sites before refactoring

Language Support

| Language | Cross-file Refs | |----------|-----------------| | Ruby | ✅ Full | | Java | ✅ Full | | Kotlin | ✅ Full | | Python | 🚧 In progress | | TypeScript | 🚧 In progress | | JavaScript | 🚧 In progress |

References

• CLI Commands - gkg index, gkg server, gkg remove, gkg clean
• MCP Tools - 7 tools for AI integration
• HTTP API - REST endpoints for querying
• Language Details - Supported features per language

Key Constraints

• Must stop server before re-indexing
• Requires initialized Git repository
• Languages not connected across repos (yet)
• TS/JS/Python cross-file refs incomplete