gitnexus

Indexes git repositories into a knowledge graph for code intelligence and impact analysis.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/maycuatroi1/agent-skills --skill gitnexus-maycuatroi1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitnexus
Source: https://github.com/maycuatroi1/agent-skills/tree/main/skills/gitnexus
Command: npx skills add https://github.com/maycuatroi1/agent-skills --skill gitnexus-maycuatroi1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gitnexus, and includes scripts (resource) components.

What problem does it solve? Understanding large or unfamiliar codebases with grep and manual reading is slow and error-prone, especially when assessing what breaks before editing a symbol or tracing execution flows across multiple repositories. ## Core Features & Use Cases - Knowledge Graph Indexing: Builds a Tree-sitter AST-based graph with import/call/type resolution, community detection, and execution-flow tracing for any git repo. - MCP Tool Workflow: Exposes query, context, impact, detect_changes, and rename tools to AI editors like Claude Code, Cursor, and OpenCode for call-graph-aware exploration and refactoring. - Multi-Repo Workspace Support: Indexes every repo under a workspace root and groups them for cross-service queries and cross-repo blast-radius analysis. - Use Case: Before renaming a shared function in a microservices workspace, run an impact query to see every upstream caller across all repos, then perform a call-graph-aware rename instead of find-and-replace. ## Quick Start Ask the agent to install GitNexus and index this repository so you can query its code knowledge graph and run impact analysis before making changes.

Frequently Asked Questions about gitnexus

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I index a repository with GitNexus?

Run gitnexus analyze inside any git repo to build the knowledge graph, stored in a .gitnexus directory. Add the --embeddings flag if you also want semantic search, since embeddings are opt-in and not built by default.

How do I analyze impact before changing a symbol?

Use the MCP impact tool with the target symbol name and direction upstream to compute the blast radius before editing. Results flagged HIGH or CRITICAL should be surfaced to the user before proceeding with the change.

Can GitNexus handle multi-repo workspaces?

Yes, the index-workspace.sh script analyzes every git repo under a root directory and can group them with gitnexus group commands. Group queries then trace execution flows and impact across all indexed services.

Why is semantic search empty after indexing?

A plain gitnexus analyze builds only the graph, not semantic embeddings. Run gitnexus analyze --embeddings to enable semantic and hybrid search; graph, flow, and impact tools work without embeddings.

Does GitNexus support Dart, Kotlin, or Swift?

Not by default, because the install script skips those optional grammars to avoid requiring a C++ toolchain. To parse them, reinstall without GITNEXUS_SKIP_OPTIONAL_GRAMMARS and with python3, make, and g++ present.

Why does the GitNexus MCP server time out in Claude Code?

A cold npx gitnexus mcp start can exceed Claude Code's roughly 30-second MCP timeout. Install globally with npm i -g gitnexus and call the gitnexus binary directly to avoid the cold-start delay.