| name | gkg |
| description | Semantic code analysis with GitLab Knowledge Graph. Use for go-to-definition, find-usages, impact analysis, architecture visualization. Supports Ruby, Java, Kotlin, Python, TypeScript/JavaScript. |
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
gkg --version
gkg index
gkg server start
gkg server stop
Installation
curl -fsSL https://gitlab.com/gitlab-org/rust/knowledge-graph/-/raw/main/install.sh | bash
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
Find Symbol Usages
- Index project:
gkg index
- Start server:
gkg server start
- Use MCP tool
get_references or HTTP API /api/graph/search
Impact Analysis
- Index affected repos
- Query
get_references for changed symbols
- 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
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
