gitnexus: Map Codebases for AI-Assisted Exploration

Overview

GitNexus builds a knowledge graph from a codebase, connecting symbols and their relationships to help reveal how code fits together. Developers can explore that graph through a CLI, a browser interface, or MCP tools that provide context to supported AI coding agents.

It is useful when ordinary code search or summaries do not show enough structure to assess dependencies and the effects of a change. The CLI indexes locally; the browser UI can analyze a repository in-browser, with its capacity limited by available browser memory unless using backend mode.

Key Features

• Indexes code into a graph of symbols, dependencies, call chains, clusters, and execution flows.
• Offers graph search, symbol context, impact analysis, path tracing, and change detection through CLI and MCP tools.
• Connects to coding agents and editors including Claude Code, Cursor, Codex, and Windsurf.
• Provides a browser UI for visual graph exploration and AI-assisted repository chat.
• Generates agent skills and context files during analysis, with options for repository-specific skills.
• Supports local repositories and repository groups for cross-repository contract and impact analysis.

Use Cases

• A developer preparing a refactor can inspect callers and affected execution flows before changing a symbol.
• An AI coding agent can retrieve dependency context while editing, helping the developer review changes with more architectural information.
• A newcomer can use the web UI to explore an unfamiliar repository without first configuring an editor integration.
• Teams working across related repositories can group indexes and inspect contracts and cross-repository links.

Project Facts

• Language: TypeScript
• License: NOASSERTION
• Stars: 173
• Forks: 16
• Topics: none listed
• Archived: no

Getting Started

From the repository root, run:

npx gitnexus analyze
npx gitnexus setup

See the GitNexus README for installation notes, supported integrations, and configuration details. The web UI is available for browser-based exploration.

Alternatives

• graphify: Graphify indexes documentation, schemas, and other project files alongside code, rather than focusing on repository code structure and execution flows.
• codegraph: CodeGraph emphasizes agent retrieval of source and call paths across many languages, while GitNexus also offers a browser UI for exploration.
• code-review-graph: Code-review-graph focuses on delivering targeted review context and impact analysis through its CLI and MCP server.
• codebase-memory-mcp: Codebase-memory-mcp is a persistent local MCP server for code-relationship queries, without GitNexus's browser UI and broader exploration focus.

Considerations

• The browser-only mode is limited by browser memory, described in the README as roughly 5,000 files; backend mode is available for larger use.
• The CLI relies on native database and parser dependencies. Some language grammars may be skipped when optional build requirements are unavailable.
• Repository metadata reports the license as NOASSERTION, while the README displays a PolyForm Noncommercial license badge. Verify the applicable terms before adopting it commercially.
• Indexes can require significant memory for large repositories, and embedding generation is optional and may add installation and runtime requirements.