GitNexus

# GitNexus

<div align="center">

  <a href="https://trendshift.io/repositories/19809" target="_blank">
    <img src="https://trendshift.io/api/badge/repositories/19809" alt="abhigyanpatwari%2FGitNexus | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
  </a>

  <p>
    <a href="https://discord.gg/MgJrmsqr62">
      <img src="https://img.shields.io/discord/1477255801545429032?color=5865F2&logo=discord&logoColor=white" alt="Discord"/>
    </a>
    <a href="https://www.npmjs.com/package/gitnexus">
      <img src="https://img.shields.io/npm/v/gitnexus.svg" alt="npm version"/>
    </a>
    <a href="https://polyformproject.org/licenses/noncommercial/1.0.0/">
      <img src="https://img.shields.io/badge/License-PolyForm%20Noncommercial-blue.svg" alt="License: PolyForm Noncommercial"/>
    </a>
    <a href="https://securityscorecards.dev/viewer/?uri=github.com/abhigyanpatwari/GitNexus">
      <img src="https://api.securityscorecards.dev/projects/github.com/abhigyanpatwari/GitNexus/badge" alt="OpenSSF Scorecard"/>
    </a>
    <a href="https://github.com/abhigyanpatwari/GitNexus/actions/workflows/ci.yml">
      <img src="https://github.com/abhigyanpatwari/GitNexus/actions/workflows/ci.yml/badge.svg" alt="CI Workflows"/>
    </a>
  </p>
</div>

GitNexus indexes a codebase into a knowledge graph of symbols, calls, dependencies
and execution flows. Use it through your coding agent's MCP tools, the CLI, or a
web graph explorer.

[Quick start](#quick-start) · [Documentation](#documentation) ·
[Web UI](https://gitnexus.vercel.app) · [Discord](https://discord.gg/MgJrmsqr62)

https://github.com/user-attachments/assets/172685ba-8e54-4ea7-9ad1-e31a3398da72

## Quick start

Requires **Node.js 22.18+ on 22.x, or 24.11+**. See [platform requirements](gitnexus/README.md#requirements)
for Linux and Windows native dependencies.

```bash
# Run from your repository root
npx gitnexus analyze

# Connect your editors once
npx gitnexus setup
```

`analyze` builds the index, installs agent skills, registers Claude Code hooks,
and writes `AGENTS.md` / `CLAUDE.md` context files. `setup` configures MCP for your
editors. Use `gitnexus analyze --index-only` to index without those repository
integration files.

For repeated use, install globally with `npm install -g gitnexus`.
If installation fails, see [troubleshooting](gitnexus/README.md#troubleshooting).

## What you can do

| Task                                        | Tool             |
| ------------------------------------------- | ---------------- |
| Find code and related execution flows       | `query`          |
| Inspect a symbol's callers and dependencies | `context`        |
| Check what a change could affect            | `impact`         |
| Trace a path between two symbols            | `trace`          |
| Review the impact of a Git diff             | `detect_changes` |
| Preview and apply a semantic rename         | `rename`         |

Ask your agent questions such as “What calls this func