GitNexus Guide

Quick reference for all GitNexus MCP tools, resources, and the knowledge graph schema.

Always Start Here

For any task involving code understanding, debugging, impact analysis, or refactoring:

Read gitnexus://repo/{name}/context — codebase overview + check index freshness
Match your task to a skill below and read that skill file
Follow the skill's workflow and checklist

If step 1 warns the index is stale, run npx gitnexus analyze in the terminal first.

Skills

| Task | Skill to read | | -------------------------------------------- | ------------------- | | Understand architecture / "How does X work?" | gitnexus-exploring | | Blast radius / "What breaks if I change X?" | gitnexus-impact-analysis | | Trace bugs / "Why is X failing?" | gitnexus-debugging | | Rename / extract / split / refactor | gitnexus-refactoring | | Tools, resources, schema reference | gitnexus-guide (this file) | | Index, status, clean, wiki CLI commands | gitnexus-cli |

Tools Reference

| Tool | What it gives you | | ---------------- | ------------------------------------------------------------------------ | | query | Process-grouped code intelligence — execution flows related to a concept | | context | 360-degree symbol view — categorized refs, processes it participates in | | impact | Symbol blast radius — what breaks at depth 1/2/3 with confidence | | detect_changes | Git-diff impact — what do your current changes affect | | rename | Multi-file coordinated rename with confidence-tagged edits | | cypher | Raw graph queries (read gitnexus://repo/{name}/schema first) | | list_repos | Discover indexed repos |

Resources Reference

Lightweight reads (~100-500 tokens) for navigation:

| Resource | Content | | ---------------------------------------------- | ----------------------------------------- | | gitnexus://repo/{name}/context | Stats, staleness check | | gitnexus://repo/{name}/clusters | All functional areas with cohesion scores | | gitnexus://repo/{name}/cluster/{clusterName} | Area members | | gitnexus://repo/{name}/processes | All execution flows | | gitnexus://repo/{name}/process/{processName} | Step-by-step trace | | gitnexus://repo/{name}/schema | Graph schema for Cypher |

Graph Schema

Nodes: File, Function, Class, Interface, Method, Community, Process Edges (via CodeRelation.type): CALLS, IMPORTS, EXTENDS, IMPLEMENTS, DEFINES, MEMBER_OF, STEP_IN_PROCESS

MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"})
RETURN caller.name, caller.filePath