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 node .gitnexus/run.cjs 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
1---
2name: gitnexus-guide
3description: "Use when the user asks about GitNexus itself — available tools, how to query the knowledge graph, MCP resources, graph schema, or workflow reference. Examples: \"What GitNexus tools are available?\", \"How do I use GitNexus?\""
4metadata:
5 source: https://skillmd.com/skills/mindfold-ai/gitnexus-guide
6---
7
8# GitNexus Guide
9
10Quick reference for all GitNexus MCP tools, resources, and the knowledge graph schema.
11
12## Always Start Here
13
14For any task involving code understanding, debugging, impact analysis, or refactoring:
15
161. **Read `gitnexus://repo/{name}/context`** — codebase overview + check index freshness
172. **Match your task to a skill below** and **read that skill file**
183. **Follow the skill's workflow and checklist**
19
20> If step 1 warns the index is stale, run `node .gitnexus/run.cjs analyze` in the terminal first.
21
22## Skills
23
24| Task | Skill to read |
25| -------------------------------------------- | ------------------- |
26| Understand architecture / "How does X work?" | `gitnexus-exploring` |
27| Blast radius / "What breaks if I change X?" | `gitnexus-impact-analysis` |
28| Trace bugs / "Why is X failing?" | `gitnexus-debugging` |
29| Rename / extract / split / refactor | `gitnexus-refactoring` |
30| Tools, resources, schema reference | `gitnexus-guide` (this file) |
31| Index, status, clean, wiki CLI commands | `gitnexus-cli` |
32
33## Tools Reference
34
35| Tool | What it gives you |
36| ---------------- | ------------------------------------------------------------------------ |
37| `query` | Process-grouped code intelligence — execution flows related to a concept |
38| `context` | 360-degree symbol view — categorized refs, processes it participates in |
39| `impact` | Symbol blast radius — what breaks at depth 1/2/3 with confidence |
40| `detect_changes` | Git-diff impact — what do your current changes affect |
41| `rename` | Multi-file coordinated rename with confidence-tagged edits |
42| `cypher` | Raw graph queries (read `gitnexus://repo/{name}/schema` first) |
43| `list_repos` | Discover indexed repos |
44
45## Resources Reference
46
47Lightweight reads (~100-500 tokens) for navigation:
48
49| Resource | Content |
50| ---------------------------------------------- | ----------------------------------------- |
51| `gitnexus://repo/{name}/context` | Stats, staleness check |
52| `gitnexus://repo/{name}/clusters` | All functional areas with cohesion scores |
53| `gitnexus://repo/{name}/cluster/{clusterName}` | Area members |
54| `gitnexus://repo/{name}/processes` | All execution flows |
55| `gitnexus://repo/{name}/process/{processName}` | Step-by-step trace |
56| `gitnexus://repo/{name}/schema` | Graph schema for Cypher |
57
58## Graph Schema
59
60**Nodes:** File, Function, Class, Interface, Method, Community, Process
61**Edges (via CodeRelation.type):** CALLS, IMPORTS, EXTENDS, IMPLEMENTS, DEFINES, MEMBER_OF, STEP_IN_PROCESS
62
63```cypher
64MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: "myFunc"})
65RETURN caller.name, caller.filePath
66```