17k stars in weeks — the zero-server code brain your AI agent actually needs

You know that feeling when Cursor or Claude Code makes a change that seems fine, but breaks 47 other things you didn't know existed? That's because AI agents don't truly understand your codebase structure — they just search and guess. Before: you manually trace call chains and hope you didn't miss anything. Now: GitNexus precomputes every relationship, cluster, and execution flow at index time, so your AI gets complete context in one query instead of 10 blind searches.

Think of it like building a GPS for your codebase. First, GitNexus walks through every file and parses it using Tree-sitter (the same tech VS Code uses for syntax highlighting). Then it builds a knowledge graph — tracking which functions call which, what imports what, which classes inherit from others. It groups related code into clusters using the Leiden algorithm and traces execution flows from entry points. Finally, it exposes 7 smart tools via MCP: query for hybrid search, context for 360-degree symbol views, impact for blast radius analysis, and more. Your AI agent calls these tools and gets structured answers, not raw data to interpret.

• Zero-server architecture — why YOU care: Everything runs in your browser or locally via CLI. No cloud, no API keys, no code uploaded anywhere. Your proprietary codebase stays on your machine.
• MCP integration for AI agents — why YOU care: One command (`npx gitnexus analyze`) indexes your repo and connects to Cursor, Claude Code, Windsurf, Codex, and OpenCode. Your AI agent instantly gains deep codebase awaren...
• Impact analysis / blast radius — why YOU care: Before you refactor UserService, GitNexus tells you exactly which 47 functions depend on it, grouped by confidence level. No more 'I didn't know that would break' moments.
• Process-grouped search — why YOU care: Search 'authentication' and get results organized by execution flow (LoginFlow, RegistrationFlow) instead of a flat list of files. You understand context, not just keywords.
• 13 language support — why YOU care: TypeScript, JavaScript, Python, Java, Kotlin, C#, Go, Rust, PHP, Ruby, Swift, C, C++. Full AST parsing with import resolution, heritage tracking, and type inference for each.
• Auto-reindex hooks — why YOU care: Claude Code hooks automatically reindex after commits. Your knowledge graph stays in sync with your codebase without manual intervention.
• Wiki generation — why YOU care: Run `gitnexus wiki` and it generates LLM-powered documentation from your knowledge graph — architecture overviews, module docs, cross-references — all grounded in actual code structure.

Who It Is For

If you're a developer using Cursor, Claude Code, Windsurf, or any AI coding assistant on a real codebase — this is for you. Especially valuable if you work on large or unfamiliar codebases where AI agents frequently miss dependencies and break things. Not useful yet if you only work on tiny scripts or need multi-GPU setups for your indexing (though the CLI handles large repos fine).

Worth Exploring?

Yes, absolutely try it. The 17.1k stars aren't hype — this solves a real pain point that every AI-assisted developer hits. The CLI + MCP integration is production-ready and takes 30 seconds to set up. The one catch: the PolyForm Noncommercial license means you can't use it in commercial products without negotiating terms. For personal and internal tool use, it's free and excellent.