Overview
GitNexus, from Akon Labs, is a context engine for codebases. It indexes a repository into a knowledge graph — dependencies, call chains, clusters and execution flows — and then exposes that graph to AI coding agents through MCP tools, so an agent asking about a symbol gets its real relationships rather than a description of them. The README draws the contrast plainly: tools like DeepWiki help you understand code, while GitNexus lets you analyse it, because the graph tracks every relationship.
There are two ways in. The CLI plus MCP server is the main one: `npx gitnexus analyze` indexes the codebase, installs agent skills, registers Claude Code hooks and writes `AGENTS.md` / `CLAUDE.md` context files, and `npx gitnexus setup` auto-detects and configures editors such as Claude Code, Cursor, Antigravity and Codex. A hosted Web UI is the quick way to chat with any repo in a browser, and Akon Labs offers SaaS and self-hosted enterprise editions.
Parsing is done with tree-sitter, including vendored grammars for Dart, Proto, Swift and Kotlin that ship as cross-built prebuilds so no C/C++ toolchain is needed. The embedding stack is an optional dependency installed on demand into `~/.gitnexus/embedding-runtime`, so a blocked download during install does not break the tool. GitNexus is published under the PolyForm Noncommercial License 1.0.0. The project also warns in its README that it has no official cryptocurrency or token, and that any coin using its name is unaffiliated.
What it does
- Indexes a repository into a knowledge graph covering dependencies, call chains, clusters and execution flows
- MCP server that hands the graph to Claude Code, Cursor, Codex, Antigravity and other MCP-capable editors
- `gitnexus analyze` also installs agent skills, registers Claude Code hooks and writes AGENTS.md / CLAUDE.md context files
- tree-sitter parsing with vendored, cross-built prebuilds for Dart, Proto, Swift and Kotlin, so no local C++ toolchain is required
- Optional embedding stack installed on demand through your own npm registry config, keeping proxied and mirrored installs working
- A browser Web UI for chatting with a repository, plus SaaS and self-hosted enterprise editions from Akon Labs
Getting started
GitNexus is distributed on npm as `gitnexus`. Two commands take you from a fresh checkout to an agent that can query the graph.
Index your repository
Run this from the repository root. It builds the knowledge graph, installs agent skills and hooks, and writes the context files.
npx gitnexus analyzeConnect your editors
A one-time step that auto-detects Claude Code, Cursor, Codex and friends and writes the MCP configuration for each.
npx gitnexus setupPrefer a global install for faster MCP startup
Installing globally before running setup writes an absolute-path MCP config that bypasses npx — worth doing, because a cold npx install can exceed an MCP client's default startup timeout.
npm install -g gitnexus
gitnexus setupIf you have no C++ toolchain
Set this strict flag to skip building the vendored Dart, Proto, Swift and Kotlin grammars; those four languages will not be parsed, but the install finishes without python3, make or g++.
GITNEXUS_SKIP_OPTIONAL_GRAMMARS=1 npm install -g gitnexusCommands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Stop an agent from shipping blind edits by giving it the real dependency and call-chain graph of the repository
- Let a smaller, cheaper model work on a large codebase by handing it structure instead of raw files
- Explore an unfamiliar repository in the browser Web UI before wiring anything into an editor
- Give several editors — Claude Code, Cursor, Codex — one shared architectural index of the same project
How GitNexus compares
GitNexus alongside other open-source code indexing & search tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| CodeGraph | ★ 70.4k | Builds a local SQLite knowledge graph of a codebase with a Rust tree-sitter kernel, keeps it in sync through a file watcher, and serves symbols, call paths and blast radius to coding agents over MCP. |
| GitNexus | ★ 47.2k | Indexes a codebase into a knowledge graph and serves it to agents over MCP |
| Claude Context | ★ 12.5k | An MCP server that indexes your codebase into a vector database so AI coding agents can find relevant code by meaning instead of loading whole folders. |
| Semble | ★ 6k | A CPU-only code search library and MCP server that indexes a repository with tree-sitter chunking, Model2Vec embeddings and BM25, so an agent retrieves the few relevant snippets instead of grepping and reading whole files. |