GitLab Knowledge Graph (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

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