GitNexus: Give AI agents a complete view of code dependencies with a knowledge graph
GitNexus gives Cursor and Claude Code a code knowledge graph, returning complete dependency context without multi-query exploration.
GitHub abhigyanpatwari/GitNexus Updated 2026-09-04 Branch main Stars 46.6K Forks 5.1K
Knowledge graph MCP Graph RAG Cursor Claude Code Browser-based

🧭 Decision Guide

Try it if you

  • You use Cursor, Claude Code, or Codex and need to inspect callers and dependencies of functions.
    The README sections “Why a Knowledge Graph?” and “Editor Setup” list these editors and use UserService to illustrate dependency analysis.
  • You want MCP to give an AI agent pre-structured architectural context in one response.
    The README section “Core innovation: Precomputed Relational Intelligence” says GitNexus performs clustering, tracing, and scoring at index time.
  • You want smaller LLMs to handle codebase architecture without relying on a 10-query chain.
    The README explicitly lists “Token efficiency” and “Model democratization” and states that smaller LLMs work.
  • You need to quickly inspect and chat with GitHub, GitLab, Azure, or local repositories in a browser.
    The project description supports Github, Gitlab, Azure, Local, and ZIP inputs; the README TL;DR says the Web UI works in a browser.

Skip it if you

  • Your environment is fixed to npm 11.x and cannot switch to pnpm or a global installation.
    The README Quick Start warns that npx on npm 11.x may fail with “Cannot destructure property 'package'” and provides pnpm and global installation alternatives.
  • Your project must parse Dart, Proto, Swift, and Kotlin, but the environment cannot provide the relevant build conditions or a matching prebuild.
    The README says GITNEXUS_SKIP_OPTIONAL_GRAMMARS=1 skips these four languages; Kotlin is unavailable when no matching platform-architecture prebuild exists.
  • Your compliance process requires an explicit open-source license type.
    The project metadata only marks the license as Other, and the provided README material does not name a specific license.
  • Your team accepts dependencies only when formal releases and active contributor records are available.
    Project metadata shows 0 contributors, 0 releases, “No releases,” and 0 recent commits.

Requirements

  • Run npx gitnexus analyze from the repository root.
  • Running npx gitnexus setup requires Node.js/npm or pnpm to be available.
  • Without a C++ toolchain, set GITNEXUS_SKIP_OPTIONAL_GRAMMARS=1.
  • The on-demand embedding runtime requires Node 22.15+ on 22.x or 23.5+ on 23.x.
  • The npx MCP installation for Claude Code may exceed the default MCP_TIMEOUT of about 30 seconds.

First step (verbatim from README)

npx gitnexus analyze

Watch out

  • Installation may crash before GitNexus runs on npm 11.x; the README suggests pnpm or global npm installation.
    README Quick Start section “On npm 11.x?”
  • With a cold cache, the npx MCP installation may exceed Claude Code's roughly 30-second MCP_TIMEOUT.
    README Quick Start section “Fastest MCP startup”.
  • An HTTP proxy may not proxy onnxruntime-node's optional CUDA download from NuGet.
    README Quick Start section “Behind an HTTP proxy / regional firewall?”
  • Setting GITNEXUS_SKIP_OPTIONAL_GRAMMARS=1 gives up parsing for Dart, Proto, Swift, and Kotlin.
    README Quick Start section “No C++ toolchain?”

Alternatives

  • DeepWiki:Use it when you only need code understanding and not GitNexus's relationship graph and impact analysis.
    README section “Like DeepWiki, but deeper.”
  • Traditional Graph RAG:Use it when your workflow explicitly requires the LLM to query raw graph edges step by step instead of using GitNexus's pre-structured response.
    README section “Why a Knowledge Graph?”

Not stated in the README

  • The complete Supported Languages list is not included in the material.
  • The memory, disk, and time requirements for indexing large repositories are not stated.
  • No performance benchmarks are provided for analysis speed, query latency, or graph-size limits.
  • The specific license text corresponding to Other is not stated.
  • The actual latest update time is not stated; the metadata says Unknown.
  • The material does not include the Security & Privacy section, so the full processing boundary for code and index data cannot be confirmed.
  • The feature differences among the Web UI, Docker, and Enterprise versions are not stated.

💡 Deep Analysis

7
It depends I install GitNexus with npm 11 on a machine without python3, make, or g++, and my repository contains Dart, Proto, Swift, and Kotlin. Can I complete the installation without sacrificing parsing for those languages?
For: A Node.js developer on npm 11 without python3/make/g++, who needs Dart, Proto, Swift, or Kotlin parsing

It depends. You may avoid a local C++ toolchain, but npm 11 introduces an installation risk, and language coverage depends on whether matching prebuilt grammars exist for your platform.

  • The README says npx can crash on npm 11.x because of an npm/arborist bug that occurs before GitNexus runs; it recommends pnpm or a global installation instead.
  • Setting GITNEXUS_SKIP_OPTIONAL_GRAMMARS=1 skips grammar materialization/build for Dart, Proto, Swift, and Kotlin, but the README explicitly says those four languages will not be parsed. That conflicts with your requirement.
  • For Kotlin, the README says GitNexus vendors prebuilt grammars and therefore normally does not require a C/C++ toolchain. However, if no prebuild matches the platform-architecture pair, Kotlin parsing is unavailable while the rest of GitNexus remains unaffected.

So the decision depends on platform prebuild availability. Do not use the skip flag if complete coverage for those four languages is required, and avoid the npm 11 npx installation path.

  • Quick Start: "On npm 11.x? `npx` can crash during install"
  • Quick Start: `GITNEXUS_SKIP_OPTIONAL_GRAMMARS=1` makes Dart, Proto, Swift, and Kotlin unavailable for parsing
  • About `tree-sitter-kotlin`: "no C/C++ toolchain is needed"; Kotlin parsing is unavailable if no prebuild matches
pnpm --allow-build=@ladybugdb/core --allow-build=gitnexus --allow-build=tree-sitter dlx gitnexus@latest analyze
Not stated in the README:The README does not list whether your exact operating system and CPU architecture have matching prebuilds for Dart, Proto, Swift, and Kotlin.;It does not provide a complete compatibility matrix for all supported Node.js versions combined with npm 11.
Yes I use Claude Code to modify public functions and continue using Cursor for impact analysis after commits, merges, or rebases. Can GitNexus help detect stale indexes and missed callers?
For: A code reviewer using Claude Code or Cursor for public-function refactoring who worries about stale indexes after commits

Yes, it is suitable for identifying potential impact and stale indexes, but it must not be treated as proof that a refactor is correct.

  • The “Why a Knowledge Graph?” example shows a breaking change to UserService.validate() where 47 functions depend on its return type. GitNexus precomputes structure so a tool response can include callers, clusters, and high-confidence results.
  • The project insights list impact, context, and detect changes capabilities, along with multi-file rename and pre-commit change detection.
  • The insights explicitly warn that commits, merges, rebases, cherry-picks, and pulls can make the index stale; GitNexus provides stale-index signaling and requires reanalysis.
  • Claude Code and Cursor both have Hooks in “Editor Setup,” allowing graph context to be added automatically. Nevertheless, compilation, tests, type checks, and review remain necessary.

It is therefore a strong entry point for public-symbol impact analysis before and after edits. Dynamic calls, reflection, generated code, and external-service relationships may still be absent from the graph.

  • Why a Knowledge Graph?: `UserService.validate()` and "47 functions depend on its return type"
  • Project insights: impact, context, detect changes, multi-file rename, and pre-commit change detection
  • Project insights: commits, merges, rebases, cherry-picks, or pulls can create a stale index
  • Editor Setup: Hooks support for Claude Code and Cursor
npx gitnexus setup
Not stated in the README:The README does not specify the stale-index detection trigger, latency, or false-positive rate.;No accuracy benchmark is provided for impact results versus real call relationships.
Yes I am behind an HTTP proxy, use Node.js 22.15 or newer, and want to run `gitnexus analyze --embeddings`. Can the installation and download path described in the README avoid direct NuGet access?
For: A developer behind an HTTP proxy or regional firewall, running Node.js 22.15+, who wants embeddings

Yes, provided that you use the README’s on-demand embedding installation path rather than relying on every download succeeding during npm install.

  • The README says that onnxruntime-node postinstall downloads optional CUDA binaries from api.nuget.org and ignores HTTP_PROXY and HTTPS_PROXY. That path is unsuitable for a proxy-restricted environment.
  • It also says embeddings are optional and that the first gitnexus analyze --embeddings or gitnexus embeddings install retrieves the stack through npm registry configuration, so mirrors and proxy-aware registry settings can apply. The runtime is stored in ~/.gitnexus/embedding-runtime by default.
  • Your Node.js 22.15+ version meets the README’s requirement for the on-demand prefix on the Node 22 line. GITNEXUS_EMBEDDING_RUNTIME_DIR can override the runtime location.

The conclusion depends on your npm registry mirror being reachable and serving the required packages. The README does not guarantee compatibility with every proxy, mirror, or regional network policy.

  • Quick Start: `onnxruntime-node` postinstall downloads from `api.nuget.org` and ignores `HTTP_PROXY`/`HTTPS_PROXY`
  • Quick Start: `gitnexus analyze --embeddings` and `gitnexus embeddings install` use npm registry configuration
  • Quick Start: Node 22.15+ and `GITNEXUS_EMBEDDING_RUNTIME_DIR`
gitnexus embeddings install
Not stated in the README:The README does not say whether a specific npm mirror contains the ONNX Runtime components required by the target platform.;It does not specify download size, duration, or licensing details for the embedding model or runtime.
Yes I only want to drop a GitHub repository or ZIP into a browser for quick Graph RAG conversations, without installing Node.js, configuring MCP, or setting up an editor. Should I choose GitNexus’s Web UI?
For: A developer who prefers quick browser exploration of GitHub repositories without configuring local Node.js and MCP

Yes, the Web UI fits this constraint because the README positions it as a browser-based, quick repository chat and exploration path rather than requiring CLI/MCP editor integration first.

  • The project description says GitNexus runs in the browser and accepts GitHub, GitLab, Azure, local repositories, and ZIP files.
  • The TL;DR explicitly separates the workflows: CLI + MCP gives an AI agent a deep architectural view, while the Web UI is “a quick way to chat with any repo in the browser.”
  • The project insights describe interactive graph exploration and a built-in Graph RAG conversation experience in the Web UI, matching a no-local-setup requirement.

One limitation remains: Web UI and CLI/MCP should not be assumed to have identical features or performance. The supplied README excerpt does not fully specify the Web UI’s support for continuous development, editor Hooks, stale-index workflows, multi-repository configuration, or advanced Cypher queries.

  • Project description: "runs entirely in your browser" and support for GitHub, GitLab, Azure, local repositories, and ZIP
  • TL;DR: "The Web UI is a quick way to chat with any repo in the browser"
  • Project insights: interactive graph exploration and built-in Graph RAG conversation in the Web UI
Not stated in the README:The supplied README excerpt does not provide a direct Web UI URL or an exact import procedure.;It does not clearly state whether browser mode supports full multi-repository, Cypher, Hooks, and index-refresh capabilities.
Yes I use Claude Code and Cursor to analyze a local repository, but I cannot upload source code to a third-party server. Is GitNexus suitable for this workflow?
For: A developer using Claude Code, Cursor, or Codex who requires source code to remain local

Yes, it is suitable because GitNexus provides a local CLI/MCP workflow in addition to its browser UI, and the README explicitly presents local repository analysis as a supported path.

  • In “Quick Start,” npx gitnexus analyze indexes a repository from its root, while npx gitnexus setup writes the MCP configuration used by an editor.
  • “Editor Setup” lists Claude Code and Cursor with MCP, Skills, and Hooks support; both are marked Full, and setup can auto-detect editors.
  • The project description says the browser UI runs client-side, while CLI + MCP exposes the graph to a local AI agent, avoiding a mandatory remote backend.

There is one qualification: local execution does not prove that every operation is network-free. The README says embeddings are optional and may download a runtime on first use. If your policy forbids all outbound traffic, you still need to verify installation, logging, and embedding network behavior in your environment.

  • Quick Start: `npx gitnexus analyze` and `npx gitnexus setup`
  • Editor Setup: Claude Code and Cursor have Full MCP / Skills / Hooks support
  • Project description: "runs entirely in your browser" and "CLI + MCP"
npx gitnexus analyze
Not stated in the README:The README does not provide a complete network-access inventory for CLI, MCP, logging, and embeddings in a strictly offline environment.;No disk, memory, or CPU benchmarks are provided for local indexing.
Yes I use a smaller model through MCP with Antigravity or Windsurf. If the model is not good at traversing dependency graphs by itself, can GitNexus reduce the number of retrieval rounds needed to understand a public function?
For: A developer using a smaller model through MCP with Antigravity or Windsurf who wants fewer code-search rounds

Yes. GitNexus is designed for this situation because it moves clustering, call-chain tracing, and relationship scoring into the indexing stage, allowing a smaller model to receive structured context through a high-level tool call.

  • The README’s “Core innovation” says GitNexus precomputes clustering, tracing, and scoring so tools can return complete context instead of making the LLM traverse raw graph edges one query at a time.
  • Its comparison shows traditional Graph RAG taking four or more queries, while the example impact UserService upstream returns eight callers, three clusters, and all results at 90%+ confidence in one query.
  • The TL;DR explicitly states: “Even smaller models get full architectural clarity.”
  • “Editor Setup” marks Antigravity’s MCP, Skills, and Hooks support as Full. Windsurf is also listed among the AI coding assistants targeted by the project insights.

This reduces context-assembly work, but it does not eliminate parser blind spots or runtime-dynamic relationships. Windsurf’s exact Hooks and Skills support should be confirmed in the complete editor table.

  • Why a Knowledge Graph? / Core innovation: "precomputes structure at index time" and the 4+ queries versus 1 query comparison
  • Why a Knowledge Graph?: "8 callers, 3 clusters, all 90%+ confidence"
  • TL;DR: "Even smaller models get full architectural clarity"
  • Editor Setup: Antigravity has Full MCP, Skills, and Hooks support; project insights list Windsurf
npx gitnexus setup
Not stated in the README:The README provides no benchmark by model size, context window, or actual token savings.;The supplied content does not include Windsurf’s complete MCP, Skills, and Hooks support level.
It depends I need to import multiple repositories from GitHub, GitLab, and Azure and have an AI agent analyze both intra-repository call chains and cross-repository relationships. Does GitNexus meet this constraint?
For: An architect maintaining repositories from GitHub, GitLab, and Azure who needs cross-repository analysis

It depends. GitNexus clearly supports the required repository sources and multi-repository tooling, but the supplied README content does not prove complete coverage of every cross-repository runtime relationship.

  • The project description lists GitHub, GitLab, Azure, local repositories, and ZIP files as import sources, which matches your ingestion constraint.
  • The project insights describe 15 per-repository MCP tools and 2 group-level tools, and explicitly identify single-repository and multi-repository architecture as supported scenarios.
  • The graph precomputes dependencies, call chains, clusters, and execution flows. Structured capabilities such as impact, context, and detect-changes are relevant to architecture exploration and change assessment.

However, the provided README excerpt does not explain how repository boundaries, version alignment, duplicate symbols, or external service calls are modeled. Static analysis can also miss relationships created through dynamic registration, configuration, reflection, or string-based calls. You need to validate the multi-repository grouping and version model before adoption.

  • Project description: support for GitHub, GitLab, Azure, local repositories, and ZIP
  • Project insights: "15 per-repo + 2 group" MCP tools and single-/multi-repository scenarios
  • Project insights: the graph records dependencies, call chains, clusters, and execution flows
npx gitnexus analyze
Not stated in the README:The README does not explain how cross-repository dependencies are discovered, deduplicated, or bound to repository versions.;No scale, performance, or cross-repository accuracy data is provided.

✨ Highlights

  • One npx gitnexus analyze indexes complete code relationships
  • MCP smart tools compress multi-query exploration into one call
  • Cursor and Claude Code support Skills and Hooks
  • 46,988 stars indicate strong community attention

🔧 Engineering

  • npx gitnexus analyze indexes dependencies, call chains, and execution flows
  • gitnexus setup automatically writes editor MCP configuration
  • Claude Code and Codex provide MCP, Skills, and Hooks
  • The Web UI lets users chat with repositories in a browser

⚠️ Risks

  • npx on npm 11.x may trigger an Arborist installation crash
  • Without a C++ toolchain, four languages will not be parsed
  • The repository shows 0 contributors and no formal releases
  • The license is marked Other, with no explicit type in the README

👥 For who?

  • Teams using Cursor, Claude Code, or Codex
  • Developers who need cross-file dependency and call-chain analysis
  • Teams wanting smaller LLMs to receive complete architectural context